离线时 composer install 失败的根本原因是默认只查远程仓库，不扫描本地 vendor/ 或缓存；唯一可靠方案是提前在有网环境运行 composer install --no-dev 并完整同步 vendor/ 目录到离线机。

离线时 composer install 报 “Could not find package x in a version matching y” 怎么办

根本原因不是网络断了，而是 Composer 默认只查远程仓库（packagist.org），离线后连本地已下载的包都找不到——它压根没去扫描 vendor/ 或缓存目录。必须提前把依赖“固化”进可离线使用的形态。

• 上线前务必运行 composer install --no-dev（或 --with-all-dependencies）并确认 vendor/ 完整，这是离线环境唯一可信的依赖来源
• 不要依赖 composer.lock 单独存在：它只是版本快照，不含代码；离线时 composer install 仍会尝试联网校验包元数据，失败即中断
• 若项目含私有包，需提前用 composer archive 打包或手动复制整个 vendor/{vendor-name}/{package-name} 目录结构到目标机

如何让 composer install 完全跳过远程请求

靠改配置或加参数硬压是行不通的。Composer 没有 “纯离线模式” 开关，强行加 --ignore-platform-reqs 或设 disable-tls 不解决包发现失败的问题。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 唯一可靠方式：用 composer install --prefer-source + 提前克隆好所有 Git 仓库到本地，并在 composer.json 中用 repositories 指向本地路径，例如：

  "repositories": [
    {
      "type": "path",
      "url": "/path/to/local/package"
    }
  ]

• 注意 path 类型仓库不支持版本约束动态解析，"version": "dev-main" 这类写法必须和本地分支名严格一致，否则报 Could not find a matching version
• 若用 dist 包（zip/tar），需配合 "type": "package" 手动声明每个包的 dist 路径和 version，维护成本高，仅适合极少数核心依赖

离线升级依赖导致版本冲突，为什么 composer update 根本跑不起来

因为 composer update 必须联网获取最新版信息、计算依赖图、检查冲突——离线时第一步就卡在无法访问 packagist.org/packages.json。

• 离线环境下禁止执行 composer update，任何参数都无法绕过这个前提
• 所谓“离线升级”，实际是：在有网机器上完成 composer update → 提交更新后的 composer.lock 和完整 vendor/ → 整体同步到离线机 → 在离线机只运行 composer install
• 若两个环境 PHP 版本或扩展不同，composer.lock 中的 platform 字段可能引发冲突，需提前在目标环境用 composer config platform.php 8.1.0 锁定平台版本

用 composer create-project 离线初始化项目为何总失败

这个命令本质是先下载 composer/composer 自身，再拉取项目模板 zip，全程强依赖网络。离线时它连自己的启动器都下不来。

• 替代做法：在有网机器运行 composer create-project vendor/name myproject --no-install，然后打包 myproject/（含 composer.json 和 composer.lock）到离线机
• 离线机进入目录后，直接 composer install --no-dev，前提是该目录下的 vendor/ 已随项目一并拷贝（或已用前述 path 仓库配好）
• 切勿尝试修改 composer.json 中的 require 后直接离线 install：新增包不会被识别，除非你已手动补全对应 repositories 配置和本地路径

事情说清了就结束。最常被忽略的一点：离线场景下，composer.lock 文件本身不解决任何问题，它只是个“待验证的账本”。真正起作用的是那个被完整搬运、结构未损、权限正确的 vendor/ 目录。