composer install --no-install是预下载所有依赖zip包的核心命令，它解析composer.lock后仅下载dist包至缓存的files/、repo/、archived/三目录，不解压不执行脚本，配合composer_disable_network=1等参数实现在离线机完整安装。
composer install --no-install 是预下载包的核心命令
想把所有依赖变成离线可用的 ZIP 包，不能靠 composer archive 或直接打包 vendor/ —— 前者只打当前项目，后者含大量运行时无关文件且跨平台易失效。真正起作用的是 composer install --no-install，它会解析 composer.lock，把所有包的 dist ZIP 下载到本地缓存，但不解压、不执行脚本。
执行前确保：
- 项目根目录存在有效的 composer.lock（由 composer update 或 composer install 生成）
- 已设环境变量 COMPOSER_PREFERS_DIST=1 或在 composer.json 中配置 "prefer-dist": true
- 私有包已注册为 dist 源（如 GitLab 的 releases 页面提供 ZIP），否则 --no-install 会跳过或报错
命令示例：COMPOSER_PREFERS_DIST=1 composer install --no-install --prefer-dist --no-scripts --no-plugins
必须完整导出缓存目录的三个子目录
只拷 ~/.composer/cache/files/ 是常见错误。Composer 离线安装依赖三部分缓存协同工作：files/（ZIP 包）、repo/（元数据 JSON，含包名→ZIP 路径映射）、archived/（归档缓存）。缺任一，composer install --prefer-dist 就会 fallback 到联网请求。
操作步骤：
- 运行 composer config --global cache-dir 查出真实缓存路径（Linux/macOS 默认 ~/.composer/cache，Windows 是 %LOCALAPPDATA%\Composer\cache）
- 打包整个缓存根目录，不要过滤隐藏文件或跳过子目录
- 验证：解压后检查 repo/https---packagist.org/packages.json 是否存在，且内容非空
离线机上必须组合使用四个关键参数
光有缓存包和 composer.lock 不够。目标机执行 composer install 时，若不显式切断网络+禁用插件脚本，仍会尝试访问 repo.packagist.org 校验元数据，导致失败或卡住。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
正确命令是：COMPOSER_DISABLE_NETWORK=1 composer install --no-interaction --prefer-dist --no-scripts --no-plugins
各参数作用：
- COMPOSER_DISABLE_NETWORK=1：硬性阻止所有 HTTP 请求（包括初始元数据校验）
- --prefer-dist：强制走 ZIP 解压路径，才能命中缓存中的 files/
- --no-scripts：防止 post-install-cmd 里调用外部命令（如 php artisan）失败
- --no-plugins：跳过插件初始化（如 hirak/prestissimo 会在内部发起并发请求）
私有包和 PHP 环境不一致是静默失败高发区
离线包在目标机“看起来安装成功”，但运行时报 Class not found，大概率是这两类问题：
- 私有包未走 dist 模式：
检查 composer.lock 中该包条目是否有 "dist": {"url": "https://..."}；若只有 "source" 字段，说明是 git clone 模式，离线无法还原
解决：删掉 composer.lock 和 vendor/，在联网机重新运行 composer update --prefer-dist
- PHP 版本或扩展不匹配：composer.lock 中每个包的 platform 约束（如 "php": "^8.0"）会在离线安装时校验
若目标机 PHP 版本低于要求，composer install 会跳过该包且不报错，导致 autoload 缺失
验证：运行 php -v 和 php -m 对比两端环境，尤其注意 mbstring、openssl、zlib
最后别忘了补一记：composer dump-autoload -o —— 否则 autoload 映射可能残留旧路径或未优化，这是离线部署后最常被忽略的一步。
