Composer的--prefer-dist和--prefer-source区别
CI中composer install卡在Cloning是因误用--prefer-source且构建机缺Git或SSH配置；应改用--prefer-dist并禁用dev依赖与autoloader扫描。
免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈
为什么CI里composer install卡在Cloning into 'vendor/xxx'？
这个问题，在持续集成（CI）环境里太常见了。十有八九，是脚本里误用了--prefer-source参数，而构建服务器上要么没装Git，要么SSH密钥配置不全。要知道，CI环境出于安全和效率考虑，通常会禁用Git协议、屏蔽GitHub等域名，或者干脆不配置部署密钥。这时候如果还坚持用--prefer-source去克隆源码，结果不是直接报错，就是无限等待，卡得你怀疑人生。
正确的做法其实很明确：要么在命令里显式加上--prefer-dist，要么去检查一下composer.json，确保全局配置里没有设置"preferred-install": "source"。在CI脚本里，通常建议这样写，一步到位：
composer install --no-dev --prefer-dist --optimize-autoloader
这个组合拳效果显著：跳过Git克隆、忽略开发依赖、还优化了自动加载器扫描，可以说是为CI环境量身定做的“三重提速”方案。
本地调试时git checkout进不去vendor目录？
这又是另一个极端了。很多开发者习惯在本地用git checkout去切换vendor里某个包的版本，结果发现命令无效。原因很简单：默认情况下，Composer使用--prefer-dist，下载的是打包好的ZIP文件，解压后的vendor目录里根本没有.git文件夹。你试试ls -A vendor/monolog/monolog | grep git，返回肯定是空的——它压根就不是一个Git仓库，你怎么能对它执行Git操作呢？
如果确实需要在vendor目录里进行git checkout dev-main或者git diff这类操作，那就必须用--prefer-source方式安装这个特定的包：
- 安装时指定：
composer require monolog/monolog --prefer-source - 或者只更新某一个：
composer update monolog/monolog --prefer-source
安装完成后，可以进到vendor/monolog/monolog目录，执行一下git log -n 3来确认已经有了完整的提交历史。
这里有个重要的提醒：如果你在本地vendor里修改了代码并提交了，下次执行composer update时，默认行为是不会保留这些本地commit的。所以，记得先把修改推送到你自己的代码分支上。
preferred-install配置写错导致全项目变慢？
配置文件的顺序，有时候就是性能的杀手。一个常见的“翻车”配置是这样的：
"config": {
"preferred-install": {
"*": "dist",
"myorg/*": "source"
}
}
看起来是想让所有包默认用dist，但自己组织的包用source。可惜，通配符*的匹配优先级（或者说，Composer的解析顺序）让后面的myorg/*规则永远不生效——因为*已经匹配了所有包。正确的顺序应该是“精确优先”，把具体的规则放在前面：
"config": {
"preferred-install": {
"myorg/*": "source",
"*": "dist"
}
}
另外，匹配模式也有讲究。"monolog"这种写法是无效的，因为它缺少了/。正确的写法应该是"monolog/*"，这样才能命中像monolog/monolog、monolog/php-handler这样的所有相关包。
用--prefer-source就能拿到最新代码？
这是一个普遍的误解。需要明确的是，--prefer-source只是改变了安装方式（从下载ZIP包变为克隆Git仓库），但它克隆的代码版本，依然严格受composer.lock文件控制。
具体来说，Composer会去克隆composer.lock里锁定的那个具体的commit hash，而不是远程仓库main分支的最新提交。比如lock文件里记录着"reference": "a1b2c3d"，那么--prefer-source就只会检出这个“a1b2c3d”提交，哪怕上游仓库的main分支已经又推进了20个新提交。
真想获取某个包的最新代码，有两种方法：要么进入对应的vendor子目录手动执行git pull；要么就使用composer update --prefer-source来更新这个包，这会触发Composer重新解析依赖并生成新的lock文件。
说到底，一个包能否被更新到“最新”版本，根本取决于包作者是否发布了新的tag，或者更新了composer.json里的version字段。这与安装时用dist还是source方式，没有直接关系。
相关攻略
Composer安装Mockery Mock库要点 直接运行 composer require --dev mockery mockery 就能装好，但装完报 “Class Mockery not found” 是最常踩的坑，问题几乎都不出在安装本身。 为什么 composer require
Composer如何快速定位 vendor 中的源码位置_利用 IDE 插件跳转【开发技巧】 遇到IDE的“跳转到定义”在vendor目录里失灵，先别急着怀疑工具。这事儿十有八九，问题出在autoload的映射关系上——要么是映射文件压根没更新，要么是路径对不上号。你得先让Composer把类和文件
根本问题是PATH中多个composer文件冲突，系统优先执行了损坏或版本不匹配的旧文件（如OpenServer中的composer bat）；应将官方路径C: ProgramData ComposerSetup bin移至PATH最前，而非删除旧条目，并验证where composer首行、com
生产环境必须使用 composer install 并严格依赖已提交的 composer lock 文件，禁用 composer update；需强制 --no-dev、验证 lock 一致性、适配 PHP 版本变更。 在生产环境中，依赖版本必须被锁定。这背后的逻辑很简单：如果不用锁定的版本，com
老项目还在用Composer1 x？一键升级Composer2享受数倍性能提升 直接升级到 Composer 2 x 版本，这条路是安全且被官方推荐的。但先别急着点下确认键，有个前提必须厘清：项目的依赖兼容性。尤其是当 composer lock 文件被重新生成后，那些藏在 require-dev
热门专题
热门推荐
Ctrl+C失灵主因是程序拦截SIGINT信号或终端子进程未清理；需检查脚本是否空捕获异常、启用VSCode自动杀进程设置、用jobs ps排查挂起任务，并避免macOS下shell hook干扰。 Ctrl+C 没反应？先确认是不是信号被吞了 在VSCode终端里按下Ctrl + C却毫无动静，这
先查真实值：运行php -r "echo ini_get( memory_limit ); "和php --ini确认CLI模式下的实际memory_limit及配置路径；php -d memory_limit=2G是PHP内核级硬限制，COMPOSER_MEMORY_LIMIT=2G是Compose
composer install必须读composer lock，因为它只按锁文件中写死的版本号、哈希值和URL安装，确保本地、CI、线上环境vendor目录完全一致；删锁文件或Git忽略它会导致隐式update、依赖不一致及运行时错误。 composer install 为什么必须读 compos
如何在VSCode中解决TypeScript路径映射及智能提示失效问题 tsconfig json里baseUrl和paths配错，路径跳转和补全就断了 VSCode的TypeScript智能体验，比如路径跳转和代码补全，其底层引擎完全依赖于tsconfig json中的baseUrl和paths配
Sublime Text窗口透明需通过Transparency插件调用系统API实现，非原生支持；Windows Linux用户须先卸载SublimeTextTrans残留、配置Package Control源后安装，macOS因SIP限制基本不可靠。 先明确一个核心概念：Sublime Text本