Composer无离线模式,所谓“离线慢”实为误判:卡顿源于fallback行为(如私有源DNS超时)、dev稳定性重试、非运行时目录autoload扫描、xdebug拖慢文件遍历等;离线应删repositories、minimum-stability、非必要autoload路径,并用php -d xdebug.mode=off composer install --no-dev --no-scripts --no-autoloader --prefer-dist配合dump-autoload --classmap-authoritative。

Composer 本身没有“离线模式”,所谓“离线配置慢”实际是误判:你遇到的卡顿几乎都发生在 composer install 或 composer dump-autoload 阶段,而这两个操作在无网络时本应极快——除非配置或环境本身有问题。
为什么“离线”反而更慢?
真正拖慢离线场景的,是 Composer 在找不到网络源时触发的 fallback 行为和低效 autoload 配置:
-
repositories里残留了未关闭的私有源(比如"type": "composer", "url": "https://private.repo"),即使没联网,Composer 仍会尝试 DNS 解析 + TLS 握手超时(默认 5 秒/次) -
minimum-stability设为"dev"且 lock 文件含dev-分支引用,离线时无法验证分支存在性,会反复重试 -
autoload配置包含"tests/": ["tests/"]或"docs/": ["docs/"],dump-autoload -o仍会扫描这些目录,哪怕你已--no-dev - PHP 启用了
xdebug(php -v可见),离线时它不参与网络但大幅拖慢文件遍历和数组生成
离线场景下必须删掉的配置项
这些配置在无网络时不是“无效”,而是“主动制造阻塞”:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 删掉
composer.json中整个repositories块(除非你真有本地 HTTP 源) - 删掉
minimum-stability和prefer-stable—— 稳定性判断依赖远程元数据,离线时无意义且触发回退逻辑 - 检查
autoload和autoload-dev,移除所有非运行时路径,例如:"examples/": ["examples/"]、"stubs/": ["stubs/"] - 确认
platform与当前 PHP 版本严格一致(如 PHP 8.2 就写"php": "8.2"),否则离线时会模拟降级查找,徒增 CPU 运算
离线 install/dump-autoload 快速命令组合
以下命令跳过所有网络依赖和非必要开销,专为离线环境设计:
- 安装依赖:
php -d xdebug.mode=off composer install --no-dev --no-scripts --no-autoloader --prefer-dist - 生成轻量 autoload:
php -d xdebug.mode=off composer dump-autoload --optimize(注意:PHP 7.4+ / Composer 2.x 下,--optimize已不如默认autoload_static.php高效;若项目类少,可直接省略此步) - 如需极致冷启动速度且满足条件(无
files加载、无运行时生成类、PSR-4 路径精准),用:php -d xdebug.mode=off composer dump-autoload --classmap-authoritative - 缓存强制走本地:
COMPOSER_CACHE_DIR=/tmp/composer-cache php -d xdebug.mode=off composer install ...
最容易被忽略的性能陷阱
离线时最隐蔽的慢点,往往不在命令本身,而在 vendor 目录结构和 PHP 运行时:
-
vendor/autoload.php被多次require(比如测试框架重复加载),应确保单例引入 -
opcache.enable_cli=1未开启,导致每次dump-autoload都重新解析 PHP 文件(CLI 模式默认关闭 opcache) - 项目根目录或
vendor/所在文件系统是 NFS/VirtualBox 共享卷,stat()调用延迟被放大,此时必须把cache-dir和临时构建过程移出共享路径 -
composer.lock里存在已删除包的残留记录(如私有包下线),离线时无法清理元数据,会卡在 dependency resolution 的 fallback 阶段


















