离线环境下 composer install 失败的根本原因是默认联网解析版本约束，而非单纯断网；需通过 composer_home 指向预置缓存、配合 --no-interaction --no-ansi --no-plugins --no-scripts 及完整 vendor/ 与 lock 文件实现可信本地安装。
composer install 时提示 Could not parse version constraint 且网络不通
断网时 composer install 失败，常见于 CI 环境或离线部署——根本原因不是“没联网”，而是 Composer 默认会尝试访问 packagist.org 解析 version 字段、校验约束、甚至下载 composer.lock 中未缓存的元数据。即使 lock 文件完整，它仍可能触发远程请求。
- 关键点：
composer install在离线模式下默认不跳过版本解析，除非显式告知 - 必须加
--no-plugins和--no-scripts防止插件偷偷联网（比如某些自定义仓库插件） -
composer.lock必须存在且与composer.json一致，否则会退化为update行为并强制联网
用 COMPOSER_HOME + composer install --no-interaction --no-ansi 强制本地模式
Composer 本身没有 --offline 开关，但可通过环境变量和参数组合实现等效效果。核心是让其完全信任本地缓存和 lock 文件，不查远程源。
- 设置
COMPOSER_HOME指向一个已预置好包缓存的目录（如/path/to/composer-cache），避免 fallback 到默认 ~/.composer（可能为空或不可写） - 必须加
--no-interaction：防止卡在交互式提示（比如问你是否信任某个仓库） - 加
--no-ansi可减少部分插件日志输出，间接降低意外触发网络调用的概率 - 不要用
composer update替代——它一定会联网，哪怕加了--dry-run
为什么 composer install --ignore-platform-reqs 不能解决断网问题？
--ignore-platform-reqs 只跳过 PHP/扩展版本检查，对网络请求零影响。很多人误以为“忽略依赖要求”等于“忽略远程源”，其实完全无关。
- 该参数作用对象是
php,ext-curl这类本地环境声明，不影响packagist.org请求逻辑 - 断网报错里出现
Could not parse version constraint，通常是因为某条require的版本字符串含通配符（如^2.0）且 Composer 找不到对应包的dist或source元数据——这些元数据断网时无法从远程加载 - 真正有效的是确保所有依赖版本已在
composer.lock中固化，且缓存路径可读
CI/离线环境推荐的最小安全流程
不是“临时绕过”，而是构建一个可复现的离线安装链。重点在于把网络依赖前置到有网阶段。
- 有网机器上运行：
composer install --no-dev --prefer-dist→ 生成完整composer.lock - 同步整个
vendor/目录 +composer.lock+composer.json到目标机器（不要只传 lock） - 目标机器执行：
COMPOSER_HOME=/tmp/composer-cache composer install --no-interaction --no-ansi --no-plugins --no-scripts - 验证：运行
composer show --installed看是否列出全部依赖，而非报错退出
最易被忽略的是 vendor 目录权限和 autoload.php 路径一致性——断网时没机会重新生成 autoload，所以 vendor 必须原样搬运，不能删了重装。
