Composer离线安装需依赖本地缓存或路径仓库：用--no-install预缓存包，断网后install可复用；或配置path仓库指向含composer.json的本地目录，再require指定分支；直接放zip或tar.gz到cache易因hash不匹配失败。
composer install 时提示 Could not fetch，但本地有 zip 包
Composer 默认联网拉取包，断网时会直接失败。它本身不支持“手动扔个 zip 进去就用”，但能通过本地仓库机制绕过网络——前提是这个 zip 包得是 Composer 兼容的格式（含 composer.json，且结构正确）。
实操建议：
- 把 zip 解压到某个目录，比如
/path/to/my-package，确保里面包含有效的composer.json - 在项目根目录的
composer.json中添加本地仓库配置："repositories": [ { "type": "path", "url": "/path/to/my-package" } ] - 然后运行
composer require vendor/name:dev-main（分支名按你包里composer.json的"version"或实际分支调整） - 注意：
path类型仓库只对require生效，composer update会跳过它；想锁定版本，得在require里写死dev-main或dev-master，不能写*或^1.0
用 composer archive 打包后，怎么离线安装？
composer archive 只是打包源码，不生成可被 install 直接识别的安装包。它本质是个 zip 工具，不是离线分发方案。
真正能复用的离线方式是预下载 + 离线模式：
- 联网时先执行
composer install --no-install（或composer update --no-install），让 Composer 把所有包缓存到~/.composer/cache - 断网后，用
composer install --no-scripts --no-plugins，它会优先从本地 cache 提取 tarball，不发网络请求 - 如果 cache 被清空或换机器，这个方法就失效——cache 是按 hash 存的，路径和网络来源强绑定
- 别依赖
archive输出的 zip 去“手动替换vendor”，容易漏 autoload、插件、脚本等元信息
把 tar.gz 放进 ~/.composer/cache/files/ 能骗过 Composer 吗？
可以，但要严格匹配缓存 key。Composer 缓存文件名是 vendor/name/version-hash.tar.gz，hash 来自完整包元数据（包括 dist URL、shasum、version 字段）。随便扔个 tar.gz 进去，大概率触发校验失败，报错 Invalid zip file, cannot extract 或 Hash mismatch。
安全做法是反向生成缓存项：
- 找一台能联网的机器，执行
composer require vendor/name:1.2.3 --no-install - 从它的
~/.composer/cache/files/vendor/name/xxx.tar.gz复制出来 - 把整个
files/目录（或至少对应子目录）拷到离线机器的相同路径下 - 确认离线机上
COMPOSER_HOME指向正确位置，再跑composer install
为什么 composer install --offline 有时还是报错？
--offline 只禁用网络请求，但不跳过所有校验。它仍会读取 composer.lock、解析依赖图、检查本地 cache 是否齐全。常见失败点：
-
composer.lock里记录了某个包的 dist URL 是 GitHub，但 cache 里只有 packagist.org 的同版本包——hash 不同，视为不同包，拒绝使用 - 用了私有 repo（如 Satis），但没在离线机上配置对应
repositories，Composer 找不到包源定义，直接 abort - lock 文件里有
source类型引用（git clone），而--offline下无法 fallback 到dist，就会卡住 - 某些插件（如
hirak/prestissimo）在离线时可能抛异常，建议断网前先composer global remove hirak/prestissimo
离线最稳的组合是：完整 cache + 未修改的 composer.lock + 所有包都走 dist（不是 source）+ 无动态仓库配置。少一个条件，就可能在某个环节掉链子。
