唯一可靠写法是composer require vendor/package:1.2.3，冒号分隔、无符号、不带v前缀、大小写敏感；装入后composer.json中为"vendor/package": "1.2.3"，composer.lock严格还原该tag版本。
装指定版本包，只用 composer require vendor/package:1.2.3 这一种写法可靠；升级旧项目不能靠改版本号硬冲，得先看清谁在拦路。
怎么用 require 装精确版本（不是 ^ 或 ~）
想锁死某个 tag，就得让 composer.json 里写的是纯数字字符串，不带任何符号。其他写法要么报错，要么悄悄漂移。
-
composer require monolog/monolog:2.9.1✅ 写入"monolog/monolog": "2.9.1"，后续composer install严格还原 -
composer require monolog/monolog=2.9.1✅ 等号语法在 Composer 2.2+ 支持，语义更直白 -
composer require monolog/monolog@2.9.1❌ 报Could not find a matching version -
composer require monolog/monolog:^2.9.1❌ 允许升到2.99.9，不是“指定” - 版本含破折号（如
RC1、beta2）必须加引号：composer require laravel/framework:"9.0.0-RC1"，否则 shell 可能截断 - 包名大小写敏感：
topthink/think-queue对，TopThink/think-queue错
为什么明明写了 2.1.0，vendor 里却是 dev-main？
这不是网络问题，是 Composer 把 2.1.0 当成了分支名 dev-2.1.0 解析——尤其当该 tag 在 Packagist 上不存在、或被标记为 abandoned 时。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
composer.lock中该包条目：version字段必须是"2.1.0"，source.type必须是"dist"（不是"source"） -
source.reference应为空或短哈希（如"a1b2c3"），**若出现 40 位长 commit hash，说明拉的是 dev 分支** - 临时解法：删掉
vendor/和composer.lock，再跑composer install - 根治法：确认版本真实存在 → 访问
packagist.org/packages/vendor/package或运行composer show -a vendor/package
旧项目升级卡住，怎么定位真正拦路的包？
报错只说 don't install laravel/framework:^10.0，但没告诉你谁封的。这时候 composer why-not 才是关键命令。
- 运行
composer why-not laravel/framework:^10.0，**从最后一行倒着读**：最后一行通常是你的根项目，往上才是阻塞来源 - 常见拦路虎：某个
require-dev包（如phpunit/phpunit）锁死了guzzlehttp/guzzle的范围 - 某行末尾带
(conflict with foo/bar >=2.0)？说明那个包自己写了conflict字段，Composer 是照章执行 - 升级要定点：
composer update laravel/framework --with-dependencies，避免全量更新把psr/log、symfony/polyfill全带偏 - 升级后立刻
git diff composer.lock，确认只有预期变更；多出一个monolog/monolog都可能埋隐患
PHP 版本不匹配不是 Composer 卡你，是它在严格执行约束
报 requires php ^8.1 but your php version is 7.4.33，不是网络慢，是当前 php -v 输出和包声明冲突了。
- 别用
--ignore-platform-reqs强装——vendor 里会混进 PHP 8.1 语法（比如match表达式），一跑就ParseError - CI 脚本里
php -v还是 7.4？得显式指定路径：/usr/bin/php8.1 composer install - 改了
composer.json里的"php": "^8.1"，但没跑composer update --lock？那composer.lock还记着旧包 -
platform配置只影响依赖解析，**完全不控制 Composer 自身版本**；团队统一 Composer 版本，得靠composer self-update 2.7.7或 CI 显式调用
最常被忽略的一点：你以为装了 2.1.0，其实 composer.lock 没提交、被 .gitignore 忽略了，CI 构建时按旧 lock 文件还原——版本号写得再准也没用。
