唯一可靠路径是 composer require vendor/package:1.2.3；@、=、空格等写法均无效，冒号为强制分隔符；composer install 仅还原 lock 文件，换版本须 remove+require 或改 json 后 update。
想装哪个版本，就装哪个版本——唯一可靠路径是 composer require vendor/package:1.2.3，其他写法基本无效或被忽略。
为什么 composer require vendor/package@1.2.3 会失败
Composer 明确不识别 @ 作为版本分隔符。写成 monolog/monolog@1.2.3 会被当成包名的一部分，直接报 Could not find package monolog/monolog@1.2.3。同理，=、==、空格后加版本等写法也全部失效。冒号 : 是强制语法分隔符，缺它必报 Could not parse version constraint。
composer require 和 composer install 的根本区别
composer install 只读 composer.lock，完全无视命令行里写的任何版本；它不是“安装指定包”的命令，而是“还原锁定状态”的命令。要换版本，只有两条路：
- 先
composer remove vendor/package，再composer require vendor/package:1.2.3 - 手动改
composer.json中对应项为"vendor/package": "1.2.3"（注意：无^、无~），然后运行composer update vendor/package --with-dependencies
漏掉 --with-dependencies 容易引发依赖冲突；只改 composer.json 却不 update，composer install 仍会装旧版——因为 composer.lock 还没更新。
版本号写错、装不到的常见原因
报 Could not find package ... at version 1.2.3，大概率不是命令写错，而是：
- 该 tag 根本没发布（
composer show vendor/package --all查不到） - 版本是预发布态（如
1.2.3-RC1），需加--stability=RC - PHP 版本不兼容（错误提示通常是
Your requirements could not be resolved，不是网络问题） - 包名大小写错误（
Monolog/Monolog≠monolog/monolog） - 版本号带了
v前缀（v1.2.3→ 必须写成1.2.3）
装完务必验证：进 vendor/vendor/package 目录看 composer.json 或 CHANGELOG，确认实际代码确实是你要的版本——别只信 composer.json 里写的那一行。
