要安装 dev-main 或 dev-develop 分支，需先用 composer show vendor/package –all 查可用分支名，再执行 composer require vendor/package:dev-main#commit-hash；同时须在根 composer.json 中设 “minimum-stability”: “dev” 且 “prefer-stable”: false，或使用 –stability-dev 参数自动配置，否则因稳定性限制无法生效。
composer require 怎么装 dev-main 或 dev-develop
直接加 dev-main 后缀就能装，但得看包本身有没有公开这个分支。很多包的 main 分支不对外暴露，composer require vendor/package:dev-main 会报 Could not find a matching version。
- 先用
composer show vendor/package --all查真实可用的开发分支名（比如dev-master、dev-next、dev-feature/x） - 如果包用 GitHub，去它的仓库首页看默认分支名——
main和master常不互通，别硬套 - 装的时候必须带完整约束写法：
composer require vendor/package:dev-main#commit-hash（加 commit hash 更稳，否则下次composer update可能拉到意外变更）
为什么 composer install 后 dev 版本没生效
常见原因是 minimum-stability 挡住了。Composer 默认只认 stable，哪怕你写了 dev-main，只要根 composer.json 里没开权限，它就自动忽略或降级。
- 在项目根
composer.json里加："minimum-stability": "dev"，并确保"prefer-stable": false（否则 prefer-stable 会悄悄把你拉回 stable 版） - 更安全的做法是局部放宽：用
composer require vendor/package:dev-main --stability-dev，这条命令会自动在composer.json中补上"stability-flags"配置 - 执行后检查生成的
composer.lock，确认version字段确实是dev-main而不是被映射成9999999-dev后又 fallback 到某个 stable tag
dev 版本依赖更新时为啥总出问题
因为 dev 分支没有固定版本号，每次 composer update 都可能拉新 commit，而 Composer 默认不会重新 resolve 整个依赖图——旧 lock 文件里的其他 dev 包可能和新拉的不兼容。
- 更新单个 dev 包时，用
composer update vendor/package --with-dependencies，强制连带更新其子依赖 - 避免混用不同稳定性：比如 A 包用
dev-main，B 包用^2.0，它们的 autoloader 或接口可能错位，运行时报Class not found或Method not exist - CI 环境里务必跑
composer install --no-interaction --no-progress，别让update悄悄改 lock 文件
本地开发想改 vendor 里的 dev 包代码怎么办
直接改 vendor/ 下的文件？改完下次 composer update 就丢。真要调试或打补丁，得走 path repo 方式。
- 在项目根目录旁建个
packages/my-fork，把目标包 clone 过来，切到你要的分支 - 在项目
composer.json的repositories里加：{"type": "path", "url": "../packages/my-fork"} - 然后
composer require vendor/package:dev-main——此时它会软链接到本地路径，改代码立刻生效，且不污染 vendor - 注意：
path类型 repo 默认启用symlink，Windows 或某些 Docker 场景可能失败，可加"options": {"symlink": false}强制 copy
实际用下来，最常卡住的不是语法，而是分支名对不上 + stability 配置漏改 + lock 文件残留旧状态。尤其团队协作时，一个成员本地改了但没提交 lock，另一个人 composer install 就会装出不一致的 dev 版本。
