composer怎么在断网时保留原有vendor结构？

断网时 composer install 失败是因为默认会联网校验元数据，必须加 –no-network 参数才能离线安装，前提是 composer.lock 未修改且 vendor 完整。

断网时 composer install 为什么失败？

因为默认行为会尝试连接 Packagist，即使 vendor/ 已存在且 composer.lock 没变，Composer 仍要校验包元数据、检查更新、甚至下载 zip 包——这些全依赖网络。不是“有缓存就能用”，而是“没网就卡在 metadata fetch 阶段”。

必须加 --no-network 参数才真正离线

这个参数告诉 Composer：别发任何 http 请求，只信本地已有内容。但它有严格前提：

• composer.lock 必须存在且未被修改（git status 显示 clean）
• vendor/ 目录需完整，或至少包含所有 lock 中声明的包（哪怕只是旧版本）
• 不能同时用 --update 或 --with-dependencies 等触发网络操作的选项

正确命令：composer install --no-network。漏掉这个参数，哪怕你本地缓存了全部 zip，它照样报 Could not fetch packages。

composer.lock 是离线安装的唯一权威依据

它不是“建议清单”，而是精确到 commit hash 或 version 的锁定快照。如果有人手动改过 require 再没跑 composer update，lock 就和 composer.json 不一致——此时 --no-network 会直接报错退出，而不是“按旧 lock 装”。常见误操作：

• 编辑 composer.json 后忘记 composer update --lock
• Git 合并冲突后手修了 composer.json，但没同步修 lock
• CI 环境用了 --prefer-dist，但本地是 --prefer-source，导致 vendor 结构不兼容

验证方式很简单：composer install --dry-run（不加 --no-network）看是否提示“Nothing to install or update”；如果是，再切到断网环境跑 --no-network 才稳。

vendor 里缺包？那不是断网问题，是缓存没配对

--no-network 不会补全缺失的包，它只跳过网络校验，然后硬装 lock 里写的路径。如果 vendor/symfony/console 根本不存在，它不会报“找不到包”，而是抛出 class 'SymfonyComponentConsoleApplication' not found 这类运行时错误——因为 autoload 失败了。

预防手段只有两个：

• 日常开发确保每次 composer install 或 update 成功后，vendor/ 和 composer.lock 一起提交（.gitignore 别乱删 vendor）
• 用 composer show --installed 对比 composer.lock 列表，快速发现漏装包

离线环境最麻烦的从来不是网络，而是你以为“上次能跑，这次肯定行”，结果 vendor 早被人删了一半还浑然不知。