离线环境下Composer install报错怎么办？本地缓存目录导入方法-composer-PHP中文网

离线环境下composer install失败，根本原因是composer默认只信任远程元数据、不查本地缓存；必须同时满足三条件：设composer_disable_network=1、composer.lock全为dist类型且zip按shasum落盘至cache-files-dir指定路径、显式配置该路径。

离线环境下composer install报错怎么办？本地缓存目录导入方法

离线环境下 composer install 报错，90% 不是没包，而是 Composer 根本没读你拷来的缓存——它默认只信远程元数据，不查本地 files/ 目录。必须同时满足环境变量、缓存结构、路径配置三者，缺一不可。

COMPOSER_DISABLE_NETWORK=1 是硬开关，但光设它没用

这个环境变量只是拦住主流程的 HTTP 请求，比如不访问 https://repo.packagist.org/packages.json；但它不会让 Composer 主动去读缓存。如果你只加了它，却没配对的 ZIP 包或路径错误，结果还是报 Could not fetch 或静默卡住。

Linux/macOS：执行前加前缀，COMPOSER_DISABLE_NETWORK=1 composer install --prefer-dist --no-scripts --no-plugins
Windows CMD：set COMPOSER_DISABLE_NETWORK=1 && composer install --prefer-dist --no-scripts --no-plugins
PowerShell：$env:COMPOSER_DISABLE_NETWORK="1"; composer install --prefer-dist --no-scripts --no-plugins
别漏掉 --prefer-dist：只有 dist 类型包（ZIP/TAR）才走缓存路径；"type": "git" 的包会直接失败

缓存目录必须完整，且只认 cache-files-dir

cache-dir 和 cache-files-dir 不是一回事：cache-dir 是顶层根目录（含 files/、repo/、archived/），而离线安装真正读取的是 cache-files-dir 下的 ZIP 文件。只复制 files/ 子目录，不配路径，等于白拷。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

联网机预打包前，先运行：composer config --global cache-files-dir /mnt/offline-cache
确认 ZIP 已落盘：ls /mnt/offline-cache/monolog/monolog/*.zip（文件名由 dist.shasum 决定）
检查 repo/ 是否存在且非空：cat /mnt/offline-cache/repo/https---packagist.org/packages.json | head -n 5
离线机上必须同步执行：composer config --global cache-files-dir /mnt/offline-cache，否则仍读默认 ~/.composer/cache/files/

路径含中文或反斜杠，会导致 file:// URI 解析失败

Composer 内部拼接 file:///path/to/xxx.zip 时，若路径含未转义中文或 Windows 反斜杠，file_get_contents() 会直接报 failed to open stream: No such file or directory，而不是提示“找不到包”。

预下载阶段就用纯英文路径：composer config --global cache-dir /tmp/composer-cache-en（Linux/macOS）或 C:\composer-cache（Windows）
Windows 用户注意：用 C:/composer-cache 或 C:\composer-cache 都可能出问题，推荐统一用正斜杠 C:/composer-cache
离线机上显式设环境变量：export COMPOSER_CACHE_DIR=/tmp/composer-cache-en（Linux/macOS）或 set COMPOSER_CACHE_DIR=C:/composer-cache（CMD）
验证方式：composer show monolog/monolog --locked 查 dist.shasum，再手动 ls 对应 ZIP 是否存在

插件和脚本会绕过 COMPOSER_DISABLE_NETWORK

COMPOSER_DISABLE_NETWORK=1 拦不住某些插件内部发起的 HTTP 请求。比如 hirak/prestissimo 在 post-install 阶段自己拉包，phpstan/extension-installer 读远程配置，这些行为完全不受环境变量控制。

必须加 --no-plugins --no-scripts 参数，彻底禁用所有插件和生命周期脚本
如果项目依赖强制启用了某插件（如 composer.json 中有 "extra": {"installer-paths": {...}}），考虑临时注释掉再试
CI 打包时，避免全局 require 插件；离线机上不要运行 composer global require
报错里出现 post-install-cmd 或 pre-autoload-dump 相关日志，基本可判定是脚本绕过导致

最容易被忽略的点：不是缓存目录空，而是 repo/ 下的 JSON 映射表缺失或损坏——Composer 需要它把 composer.lock 里的包名+版本，映射到本地 ZIP 文件路径。哪怕 files/ 里 ZIP 全在，没有这张表，它也不知道该读哪个文件。