vendor存在但composer install仍报“Could not find package”，主因是Composer默认联网校验元数据，离线时需设COMPOSER_DISABLE_NETWORK=1并确保composer.lock合法、vendor为空、PHP环境一致。
vendor 存在但 composer install 仍报 “Could not find package”
这不是文件丢了，是 Composer 在离线时仍试图校验远程元数据。即使 vendor/ 目录完整、composer.lock 也存在，只要没显式禁用网络通路，composer install 就会卡在 Could not fetch https://repo.packagist.org/packages.json 或直接报 Connection refused。
关键点在于：Composer 默认行为不是“有 vendor 就跳过”，而是“先联网确认包是否存在、版本是否合法、哈希是否匹配”。这个步骤无法跳过——除非你切断所有触发路径。
-
COMPOSER_DISABLE_NETWORK=1是硬性前提，不设它，所有--no-xxx参数都无效 - 全局配置残留会导致 fallback 校验：
composer config --global repo.packagist false必须执行 -
composer.lock中若含"source": {"type": "git", "url": "..."}或"dev-master"类条目，离线时无法解析，install 必然失败 - 项目级
composer.json若写了"repositories": [{"type": "packagist", "url": false}]，在COMPOSER_DISABLE_NETWORK=1下会直接退出，不是静默忽略
离线安装前必须验证的三件事
别等 composer install 报错才回头查。以下三项任一缺失，离线流程就注定失败：
-
composer.lock文件必须存在且 JSON 格式合法（可用php -l composer.lock快速验证） -
vendor/目录不能提前存在——离线部署要求 clean slate，否则旧包可能干扰锁文件比对 - PHP 环境必须一致：版本号、启用的扩展（
mbstring、openssl、zlib）、以及composer自身版本（建议与构建机完全相同）
特别注意：composer.json 里写的 "require" 版本范围（如 "^8.0"）在离线时毫无意义——composer install 只读 composer.lock，不解析任何版本约束。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么切镜像、清缓存对离线问题完全无效
镜像（如阿里云源）和 composer clear-cache 解决的是「联网下载失败」，不是「离线拒绝工作」。它们对 COMPOSER_DISABLE_NETWORK=1 场景无任何作用，甚至可能误导排查方向。
- 镜像配置只影响 HTTP 请求目标，不影响是否发起请求；离线时根本不需要它
-
clear-cache清的是~/.composer/cache/，而离线失败发生在元数据校验阶段，不涉及缓存读取 - 运行
composer diagnose在离线环境下会主动报错（因它默认检查网络连通性），此时应跳过该命令
真正有效的验证方式，是在离线机上直接执行：COMPOSER_DISABLE_NETWORK=1 composer install --no-interaction --no-plugins --no-scripts --no-dev --optimize-autoloader。失败了，说明 lock 文件或环境不匹配；成功了，再补一句 composer dump-autoload -o 确保自动加载路径干净。
离线失败后最该看的那行错误信息
不要扫屏找关键词，直接翻到终端输出最后一行。真正指向根因的只有那句：
-
Could not find package xxx in a version installable using your PHP version→ 锁文件里记录的版本与当前 PHP 不兼容（比如用了php: ^8.2的包，但离线机是 PHP 8.1） -
Package xxx is abandoned→ 该包已被作者弃用，lock 文件中仍保留其引用，离线时无法回退到历史源 -
Failed to extract xxx: unable to create ... Permission denied→ 目标机vendor/父目录权限不足，或挂载为只读文件系统
这些错误和网络无关，改配置、换镜像、删缓存全无意义。唯一解法是回到构建机，用相同 PHP 环境重新生成 composer.lock，或手动编辑 lock 文件剔除不兼容项——离线环境本身没有纠错能力，它只忠实地执行锁文件契约。
