因为 composer install 不解析 composer.json 的版本约束，它只按 composer.lock 里锁定的版本安装；哪怕 composer.json 改为 "^3.0"，只要 lock 文件仍锁着 v2.10.3，就照装旧版，需删 lock 后重装或执行 composer update monolog/monolog 才能生效。
composer install 为什么不用 composer.json 里写的版本？
因为 composer install 不解析 composer.json 的版本约束，它只按 composer.lock 里锁定的版本安装。哪怕你刚改了 composer.json 里的 "monolog/monolog": "^3.0"，只要 composer.lock 还锁着 2.10.3，它就照装旧版。
常见现象：
- 改完
composer.json后运行composer install，vendor 里还是老版本 -
composer show monolog/monolog显示 v2.x，但你明明写了^3.0 - CI 构建结果和本地不一致——因为有人没提交新的
composer.lock
解决方法只有两个：
- 删掉
composer.lock，再跑composer install（全量重解依赖树） - 或者改完
composer.json后，运行composer update monolog/monolog（只更新这个包并刷新 lock）
为什么 composer update 升级后版本还是不对？
不是没升级，而是你没告诉 Composer 哪些包要升。默认 composer update 只更新 composer.json 中直接声明的包（即 root require），不会动传递依赖。比如你写了 "laravel/framework": "^11.0"，它会升 Laravel，但不会主动升它依赖的 symfony/console ——除非那个包也被你显式列在 require 里。
容易踩的坑：
- 以为
composer update是“全量升级”，其实它很克制 - 看到
symfony/console版本旧，却没在composer.json里声明它，结果 update 不动它 - 用了
--with-all-dependencies，但它会把所有间接依赖也拉到最新 stable 版，可能引入不兼容变更
更稳妥的做法：
- 明确指定要更新的包：
composer update symfony/console - 加
--dry-run先看会装什么：composer update symfony/console --dry-run - 如果必须批量更新间接依赖，用
composer update --with-dependencies（注意不含all-，它比--with-all-dependencies更收敛）
为什么 packagist 上明明有 v3.0，composer install 却只装 v2.x？
不是找不到，是被稳定性规则拦住了。^3.0 默认只匹配 stable 版本，而 v3.0 可能只是 dev-main 或 v3.0.0-beta1，没打 stable tag。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
验证方式：
- 查真实可用版本：
composer show -a monolog/monolog，看输出末尾的 stability 标记（stable / RC / beta / dev） - 访问 https://www.php.cn/link/6daab15a4f57549b7f236d7f0cfca3c8，点 “Versions” 标签页，确认 v3.0 是否标为 stable
临时允许非 stable 版（仅调试）：
- 在
composer.json顶层加："minimum-stability": "beta"（或"dev"），同时建议保留"prefer-stable": true - 或者直接指定分支：
"monolog/monolog": "dev-main"，但注意dev-前缀不能漏
别写 "monolog/monolog": "3.0.0" ——如果这个 exact tag 不存在，就会报 could not find a matching version。
为什么换了 PHP 版本，装出来的包还是旧版？
Composer 解析依赖时，会优先尊重 "config": {"platform": {"php": "8.1.0"}} 的声明，而不是你当前 php -v 的结果。如果你在 composer.json 里写了 "platform": {"php": "8.1.0"}，那即使你本地是 PHP 8.3，它也会按 8.1 的兼容范围选包 —— 某些包在 8.1 下只提供 v2.x，在 8.3 下才发 v3.x。
检查路径：
- 运行
composer config platform.php看是否被手动设过 - 搜
composer.json里有没有"platform"字段 - 注意：这个配置会影响所有依赖的可选版本范围，不只是 PHP 自身扩展
真正影响版本选择的，是 Composer 解析时“假装运行在哪个环境”。改完 platform 后，必须删 composer.lock 再 composer install，否则 lock 文件里的旧决策不会自动刷新。
容易被忽略的一点：Composer 2.2.x 及更早版本对 platform 配置支持不完整，可能导致 autoload 映射生成异常，进而运行时报 Class not found —— 即使版本装对了，类也加载不了。
