如何安装Composer的历史旧版版本？

本文共计962个文字，预计阅读时间需要4分钟。

直接使用命令`composer require vendor/package:1.2.3`即可安装旧版本，其他写法有很大概率失败——不是Composer不支持，而是因为语法、解析逻辑和文件机制不匹配。

用 composer require vendor/package:1.2.3 装精确版本

这是唯一推荐的入门方式。它会自动改 composer.json、重算依赖、更新 composer.lock，并安装指定版本到 vendor/。

• vendor/package 大小写必须完全匹配，monolog/monolog 对，Monolog/Monolog 报错
• 版本号不能带 v 前缀，1.2.3 对，v1.2.3 会被当成分支名 dev-v1.2.3，找不到就失败
• 别写成 vendor/package@1.2.3 或 vendor/package=1.2.3，Composer 全部忽略，报 Could not find a matching version
• 执行后立刻检查 composer.json 里是否变成 "vendor/package": "1.2.3"（无 ^、无 ~）

装完发现还是新版？先查 composer.lock 是否被覆盖

如果你刚运行过 composer update，composer.lock 已被更新，那下次 composer install 就只会还原那个“新”版本——你根本没回到旧版。

• 想靠 composer install 还原旧版，前提是 composer.lock 里存着你要的旧版本记录
• 如果 lock 文件已被覆盖，但 Git 历史里还有，用 git checkout HEAD~1 -- composer.lock 恢复它再 composer install
• 手动改 composer.lock 极危险：字段 dist.sha256 校验不通过会直接报 Invalid lock file. Corrupted.
• 不要删 vendor/ 后只跑 composer install——如果 lock 文件里没有旧版，它照样装新包

降级已存在的包，避免牵连其他依赖

项目里已有 guzzlehttp/guzzle 7.8.0，只想降到 7.4.5，又不想动 symfony/http-client 等其他包，就不能全量 composer update。

• 用 composer update guzzlehttp/guzzle:7.4.5，它只重新解析这个包及其直系依赖，其余保持不变
• 如果报 Your requirements could not be resolved，不是网络问题，是依赖冲突；试试加 --with-all-dependencies
• 别用 composer require guzzlehttp/guzzle:^7.4——它可能装 7.4.9，不是你要的 7.4.5
• 执行前建议先 composer show guzzlehttp/guzzle 确认当前版本，避免误操作

装老框架（如 Laravel 5.8）要加 --stability

像 Laravel、Symfony 这类大框架的老版本，常被标记为 stable，但有些实际发布时用了 RC 标签，或者 Packagist 默认不展示归档版本。

• 正确命令是：composer create-project laravel/laravel=5.8.* myapp --stability=stable --prefer-dist
• 漏掉 =5.8.* 或写成 5.8（没通配符），会报 Could not find package
• 若提示 no matching package found，可加 --repository-url=https://packagist.org 显式指定源
• 极老版本（如 Symfony 2.3）可能要求 PHP 5.3，而你本地是 PHP 8.2，得临时加 --ignore-platform-reqs，但运行时仍需注意兼容性

最容易被忽略的是：composer install 从不读命令行里的版本参数，它只忠于 composer.lock；而 composer require 的冒号后面那一串，才是唯一真正生效的“指定版本”入口——其他所有写法，要么被忽略，要么触发意外解析。