直接执行composer require vendor/package默认安装最新稳定版，但该版本可能不兼容当前php环境（如要求php≥8.1而本地为7.4），且跳过dev分支；需显式指定dev-main@dev等并配置--stability=dev或minimum-stability: dev才能安装开发版。
直接执行 composer require vendor/package 默认装的是最新稳定版，但“最新”不等于“开发版”，更不等于“兼容你当前 PHP 版本的版本”。很多报错其实不是 Composer 本身的问题，而是你没意识到：包的最新版可能要求 PHP ≥ 8.1，而你的环境是 7.4。
composer require 不指定版本时到底装了什么
不写版本号，composer require monolog/monolog 会按以下逻辑选版本：
- 优先匹配
^2.10这类符合当前minimum-stability（默认stable）的最高稳定版 - 跳过所有
dev-、alpha、beta分支，哪怕它们 commit 更近 - 受
platform配置限制：如果composer.json里写了"config": {"platform": {"php": "7.4.33"}}，那即使包有 3.x 版，也不会被选中
想装真正最新的（含 dev-main），必须显式声明
开发版不是点个按钮就来的，它需要绕过稳定性约束，并承担随时 break 的风险：
- 临时启用：
composer require vendor/package:dev-main --stability-dev --prefer-source - 永久允许：
composer config minimum-stability dev+composer config prefer-stable true（后者保底用 stable，只在必要时退到 dev） -
--prefer-source很关键：避免拉取已打包的 zip，而是 clone git 仓库，否则dev-main无法更新到最新 commit - 装完别忘了检查
composer.lock里对应条目是否是"reference": "xxx"而不是"version": "x.y.z"，否则不是真 dev
为什么 composer update 有时不升级到“最新”
composer update 不是“升到最高”，而是“在约束范围内重算最优解”。常见卡点：
-
composer.json里写死了"monolog/monolog": "^1.26"，那再新也只会到 1.x 最后一个 patch - 其他已装包依赖了旧版，比如
laravel/framework锁在9.52.0，它要求monolog/monolog≤2.8，那你手动 require^3.0就会冲突 - PHP 版本不达标：
composer update -w（即--with-dependencies）会把底层不兼容的包直接过滤掉，连候选都不进 - 本地缓存残留：
composer clear-cache后再试，尤其换过镜像源之后
装完发现不是预期版本？先看这三行命令输出
别急着重装，先快速定位问题根源：
-
composer show vendor/package—— 看实际安装的版本、支持的 PHP 范围、是否 source clone -
composer depends vendor/package—— 查谁在拖后腿，强制锁低版本 -
composer why-not php:8.2—— 如果你想升 PHP，这条能列出所有拦路的包及其不兼容原因
最常被忽略的是 platform 配置和 lock 文件残留——它们不会因为删了 vendor 就自动失效，得手动 composer update --lock 或删 lock 后重装。
