唯一可靠方式是composer require vendor/package:1.2.3；其他如@、=、install加版本等均失败；装composer自身须用self-update 2.7.7；版本需存在且匹配稳定性策略。
装指定版本的包，只用 composer require vendor/package:version 这一种可靠方式；想装 Composer 自身的特定版本，得用 composer self-update 2.7.7，别去碰 installer 脚本或 composer install 命令——它们根本不接受版本参数。
composer require vendor/package:1.2.3 是唯一有效写法
所有其他形式都会失败或产生意外行为：
-
vendor/package@1.2.3或vendor/package=1.2.3→ 报Could not find a matching version -
composer install vendor/package:1.2.3→ 忽略冒号后内容，甚至报Unknown argument -
^1.2.3或~1.2→ 允许小版本漂移，不是“指定版本”的本意 - 包名大小写敏感：
monolog/monolog:1.2.3对，Monolog/Monolog:1.2.3错
加引号更安全，尤其当版本含破折号（如 "laravel/framework":"9.0.0-RC1"），可防 shell 解析错误。
装不上？先查版本是否存在，而不是反复重试
报 no matching package found 时，大概率是版本根本没发布、被标记为 abandoned，或稳定性不匹配：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开 Packagist 页面搜
vendor/package，确认你要的1.2.3是否存在、状态是否为stable - 若只有
1.2.3-RC1，但项目minimum-stability是stable，需临时放宽：composer require vendor/package:1.2.3-RC1 --stability=RC - 运行
composer show -a vendor/package查所有可用版本（含 dev/RC/beta），比盲猜快得多 - 页面标了
abandoned？点开看推荐替代包，硬装旧版可能在 runtime 报错
装完发现还是 dev 分支？检查 composer.lock 的 source.reference
你以为装了 2.1.0，结果 vendor/ 里是最新 commit —— 很可能是 Composer 把 2.1.0 当成分支名 dev-2.1.0 解析了：
- 打开
composer.lock，找到该包条目，确认version字段是"2.1.0"，且source.type是"dist"（不是"source"） -
source.reference应为空或短哈希（如"abc123"），**不是长 commit hash**；若是长 hash，说明拉的是dev-main - 临时解法：删掉
vendor/和composer.lock，再跑一次composer install - 根治法：写法明确，用
"2.1.0"（带引号）或=2.1.0（等号前不加空格）
Composer 自身版本和项目包版本完全无关
这是最容易混淆的点：改 composer.json 或跑 require，对 Composer 工具本身版本毫无影响：
- 升级 Composer 自身：用
composer self-update 2.7.7（支持 RC 版，如2.8.0-RC1） - 别用官方 installer 脚本指定版本——它只认
--version=2.7.7，且仅限已发布的稳定 tag，不支持^2.7等写法 - Windows 用户下
Composer-Setup.exe不支持指定版本，必须走 CLI +self-update - 验证当前 Composer 版本：用
php composer.phar --version，别信composer --version——后者可能调的是 PATH 里的旧版
真正麻烦的不是语法，而是锁文件里 source.reference 和 version 的隐式不一致，这种问题往往要进 vendor 目录用 git log -n1 才能揪出来。
