--prefer-source 能拿到完整 Git 仓库，因为 Composer 会克隆远程 Git 仓库到 vendor/，保留 .git 目录和全部历史记录，但要求包的 composer.json 中声明了有效的 source 类型仓库地址。
为什么 --prefer-source 能拿到完整 Git 仓库
Composer 默认用 dist（压缩包）安装包，速度快但只有代码，没 .git 目录、没历史记录、没法 git blame 或切分支。加 --prefer-source 后，它会改用 source 方式：克隆远程 Git 仓库到 vendor/xxx/yyy，保留完整工作区。
注意：这要求包的 composer.json 里必须声明了 source 类型的仓库地址（通常是 "type": "git" + "url"），否则 Composer 会退回到 dist 并静默忽略该参数。
- 只对支持 source 安装的包生效（Laravel、Symfony 官方包基本都支持；很多 Packagist 上的小众包可能只提供 dist）
- 首次安装变慢，尤其大仓库（比如
laravel/framework）要下载完整历史 -
vendor目录体积明显增大（多出 .git 文件夹，通常翻倍）
composer install 和 composer require 都能用 --prefer-source
不是只有初始化项目才需要源码——调试时临时加个包、想立刻进 vendor 看实现，直接 composer require foo/bar --prefer-source 最快。
已存在的项目补加？没问题。但注意：composer install 默认读 composer.lock，而 lock 文件里记录的是上次安装时用的 type（dist/source）。所以想强制全部转成 source，得加 --ignore-platform-reqs 不够，得删 lock 再重装：
rm composer.lock composer install --prefer-source
更稳妥的做法是只对特定包生效：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer require monolog/monolog --prefer-source
- 全局配置
COMPOSER_PREFER_SOURCE=1也能生效，但容易误影响 CI 或生产环境，不推荐 - 如果包已存在且是 dist 模式，
composer update foo/bar --prefer-source可以单独切换它 -
--prefer-dist和--prefer-source互斥，后者优先级更高
调试时进 vendor 目录发现没有 .git？先查 composer show
执行 composer show vendor/package，看输出里的 source 行是否存在、URL 是否可访问。常见失败场景：
- 包作者没填
source字段，只写了dist—— 此时--prefer-source被忽略，Composer 不报错也不提示 - Git 仓库设为私有，但本地没配 SSH key 或 token，克隆失败后自动 fallback 到 dist
- 网络被墙，
git clone https://...超时，Composer 改走dist（日志里会写Cloning failed, falling back to dist）
验证是否成功：进 vendor/vendorname/packagename，运行 git remote -v。有输出就说明是 source 模式；如果报 fatal: not a git repository，那就是 dist。
CI/CD 和生产环境别默认开 --prefer-source
CI 流水线里用 --prefer-source，大概率会触发大量重复 clone，拖慢构建；生产服务器上它让部署包体积膨胀、启动变慢（某些 autoloader 扫描逻辑会受 .git 影响）。
真正需要它的场景其实很窄：本地开发时想快速 git checkout 某个提交、给上游提 PR、或排查一个只有在特定 commit 才复现的 bug。
顺手记一嘴：有些 IDE（如 PHPStorm）的 “Go to Declaration” 在 source 模式下能跳进 vendor 里的真实文件路径，dist 模式下可能只跳到生成的代理类或 stub，这点也值得权衡。
