推荐避免直接依赖 dev-master，必要时应通过指定 commit hash、设置 minimum-stability 和 prefer-stable、使用 fork 仓库或本地补丁等方式确保可控性与可维护性。
直接依赖 dev-master 不推荐，但有时确实绕不开——比如你正在等某个包的 PR 合并、修复尚未发版，或参与开源协作。关键不是“能不能用”，而是“怎么用得稳、可维护、不坑队友”。
优先用更稳定的替代方案
在伸手要 dev-master 之前，先确认有没有更稳妥的选择：
- 查该包的 GitHub Releases 或 Packagist 版本列表，看是否有带
-dev后缀的预发布版本（如v2.5.0-beta1），它们比dev-master更可控； - 用
composer show vendor/package --all查看所有可用分支和标签，有时dev-main或dev-next分支语义更明确； - 如果只是需要某次提交的修复，直接指定
dev-master#commit-hash（如"vendor/package": "dev-master#abc1234"），避免后续推送破坏兼容性。
锁定分支 + 禁用自动更新
若必须用 dev-master，务必配合 minimum-stability 和 prefer-stable 控制风险：
- 在
composer.json中显式设置："minimum-stability": "dev",<br>"prefer-stable": true
—— 这样其他包仍优先装稳定版，仅对明确声明dev-的依赖才走开发分支； - 给该依赖加
@dev标签（如"vendor/package": "dev-master as 1.0.x-dev"），既满足版本约束语法，又让composer update不轻易升级到不兼容变更； - 运行
composer update vendor/package --with-dependencies时加--no-dev要谨慎——它可能跳过你依赖的 dev 包，导致安装失败。
用仓库配置精准控制源
当上游主仓库不稳定或你想临时打补丁时，可以 fork 并指向自己的仓库：
- 在
composer.json的repositories数组中添加私有 Git 地址：{"type": "vcs", "url": "https://github.com/yourname/package"}； - 然后依赖写成
"vendor/package": "dev-your-branch-name"，这样完全脱离原master的波动； - 记得在 README 或
composer.json的extra字段里注明 fork 原因和同步计划，方便后续回归主干。
上线前务必移除或降级
dev-master 是开发态，绝不该出现在生产环境：
- CI 流程中加入检查：用
composer show --direct | grep 'dev-'报警； - 上线前执行
composer update vendor/package --with-dependencies，尝试升到最新稳定版； - 如果稳定版仍不满足需求，考虑把关键代码复制进项目本地（打个
src/VendorPatch/目录），加注释说明来源和待替换时机，比长期卡在dev-master更可持续。
基本上就这些——不复杂，但容易忽略细节。核心就一条：让 dev-master 只在必要时存在，且始终处于你的掌控之中。
