离线安装Composer依赖必须同时满足三要素：cache-files-dir、COMPOSER_DISABLE_NETWORK=1和--prefer-dist，缺一不可；镜像仅加速在线下载，不改变默认联网校验逻辑，未设该环境变量时即使vendor和lock完整也会报Could not fetch packages.json。
无网络环境下，Composer 镜像源本身不提供离线能力——COMPOSER_DISABLE_NETWORK=1 才是硬性开关，镜像只是加速在线环节的“副产品”。离线能跑通，靠的是三者绑定：cache-files-dir + COMPOSER_DISABLE_NETWORK=1 + --prefer-dist，缺一不可。
为什么配了阿里云镜像还报 Could not fetch packages.json
镜像只改下载地址，不改联网行为。Composer 每次运行 composer install 都会默认请求 packages.json 校验元数据，哪怕 vendor/ 和 composer.lock 全在，只要没设 COMPOSER_DISABLE_NETWORK=1，它就一定会连网。
- 验证是否生效：运行
env | grep COMPOSER_DISABLE_NETWORK，输出必须是COMPOSER_DISABLE_NETWORK=1 - 加了这个变量后，若
composer.lock里某包的dist.url是https://开头且没配本地仓库，会直接报错退出，不是静默跳过 - 临时验证断网效果：往
/etc/hosts（Windows 是%SystemRoot%\System32\drivers\etc\hosts）加一行127.0.0.1 repo.packagist.org，再跑composer install -v，看到Connection refused才算真正切断
cache-files-dir 是唯一该配的缓存路径
cache-dir 下混着 repo/（元数据）、archived/（解压副本）、files/（原始 zip），但只有 files/ 子目录里的 vendor-name-package-version.zip 被 --prefer-dist 直接读取。其他子目录断网即失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清掉旧配置：
composer config --global --unset cache-dir - 显式设路径：
composer config --global cache-files-dir /opt/composer-offline-cache（必须是真实存在、可写的绝对路径） - 检查是否落进去了：进入该路径，找类似
monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip的嵌套结构 - 路径含中文（如
/home/张三/.composer/cache）会导致file://协议解析失败，务必用纯英文路径
离线安装必须用这组命令组合
前提是你已在联网机上用相同 PHP 版本、扩展（如 ext-zip）、Composer 主版本（如都是 2.7.x）执行过完整安装，并确保所有包走的是 --prefer-dist（即 dist.type 是 zip 或 tar，不是 source）。
- Linux/macOS：
COMPOSER_DISABLE_NETWORK=1 composer install --prefer-dist --no-plugins --no-scripts --no-autoloader - Windows CMD：
set COMPOSER_DISABLE_NETWORK=1 && composer install --prefer-dist --no-plugins --no-scripts --no-autoloader - PowerShell：
$env:COMPOSER_DISABLE_NETWORK="1"; composer install --prefer-dist --no-plugins --no-scripts --no-autoloader - 最后补一记：
composer dump-autoload -o，否则类加载失败，报Class not found
项目级镜像配置比全局更可靠
全局配置（-g）只对当前 shell 用户生效。宝塔后台、GitHub Actions、Docker 容器往往用不同用户（如 www、runner、非 root），根本读不到你的 ~/.composer/config.json。
- 进项目根目录（有
composer.json），运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 它会自动向
composer.json的repositories字段写入"packagist": {"type": "composer", "url": ".../"} - 如果原
repositories是数组格式（[]），命令会失败；需先手动改成对象{} - 改完必须删掉
vendor/和composer.lock，再跑composer install——update会复用旧 lock，可能仍指向海外源
最容易被忽略的是 cache-files-dir 和 COMPOSER_DISABLE_NETWORK=1 的绑定关系：前者管“包在哪”，后者管“要不要找包”。两者必须同时存在、路径一致、权限可读，且每次运行前都得确认环境变量已加载——靠猜或一次配置就一劳永逸，基本都会在离线时卡住。
