Composer默认跳过dev分支源码，因稳定性约束优先级高于--prefer-source；必须同时设"minimum-stability":"dev"、"prefer-stable":false，并在require中明确写"vendor/pkg":"dev-main"，才能强制git clone。
Composer 默认会跳过 dev 分支的完整源码，只下 dist 包（如果有的话），想强制走 git clone 拉取 dev 版本的完整源码，关键不是靠 prefer-source 单独生效，而是要配合 "minimum-stability": "dev" 和 "prefer-stable": false 一起用。
为什么 prefer-source 单独设了也不拉 dev 分支？
因为 Composer 的稳定性约束优先级高于源码获取方式。即使你运行 composer install --prefer-source，只要依赖声明的是 "monolog/monolog": "^2.0" 这类稳定版约束，它就根本不会考虑 dev-main 或 dev-feature/x 这些 unstable 版本 —— 更别说去 clone 它们了。
-
prefer-source只控制「已选定版本」是用git clone还是zip download，不决定选哪个版本 - 真正决定能否匹配到 dev 分支的，是
minimum-stability和require中的版本写法 - 如果包本身没有打
dev-前缀的版本别名（比如dev-main），仅靠--prefer-source是无效的
实操：强制安装并 clone dev-main 分支
以你想调试 laravel/framework 的 main 分支为例：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的根级加上："minimum-stability": "dev",<br>"prefer-stable": false
- 把依赖写成明确的 dev 别名：
"laravel/framework": "dev-main"
（不是"dev-main as 10.0"，除非你要 alias 成某个稳定版号） - 删掉
vendor和composer.lock，再运行：composer install --prefer-source
- 验证是否成功：进
vendor/laravel/framework，执行git remote -v，看到 git 地址且有origin/main分支即为生效
require 里写 dev-xxx 和 #xxx 的区别
两种写法都能触发源码拉取，但行为不同：
-
"package/name": "dev-main"：走 Composer 的版本别名解析，要求包的composer.json里有对应分支映射（大多数主流包都有）；拉取后composer.lock记录的是 commit hash + branch 名 -
"package/name": "dev-main#abc123"：强制锁定到某次 commit，绕过别名解析；适合临时调试某次提交，但下次composer update不会自动更新到新 commit -
"package/name": "dev-main as 9.99.99"：仅用于兼容 require 中必须写稳定版号的场景（比如被其他依赖硬约束），实际仍走dev-main；不推荐滥用，容易混淆 lock 文件语义
常见失败现象和排查点
执行完 composer install --prefer-source 后还是没看到 .git 目录？检查这几处：
- 是否漏了
"minimum-stability": "dev"？这是最常被忽略的前提 - 依赖是否真的存在
dev-main别名？可访问 packagist.org 页面看 “Versions” 标签页，或直接composer show package/name --all - 有没有其他依赖间接 require 了同一包的稳定版（如
^8.0）？Composer 会按最严格约束降级，导致冲突或回退到 dist -
composer.lock里该包的"source"字段是否为空？非空且含"type": "git"才表示走的是 source
dev 分支的源码拉取看似只是加个参数，实际是稳定性策略、版本解析、锁文件三者联动的结果。少一个环节，--prefer-source 就只是个摆设。
