离线安装 composer 时需提前在联网机生成本地仓库并禁用 packagist 回源：用 satis 构建 mirror，离线机配置 composer config repos.packagist false 并执行 composer install --no-dev --prefer-dist 重建 autoload。
离线安装时 composer install 报错“Could not fetch”怎么办
离线环境下，composer install 默认会尝试连接 packagist.org，失败后直接中断。这不是网络超时问题，而是 Composer 根本没走缓存逻辑——它默认只缓存成功下载的包，且不主动复用本地已有的 .zip 或 .tar.gz 文件。
关键不是“怎么跳过网络”，而是“怎么让 Composer 主动信任本地已有资源”。必须提前在有网机器上完成两件事：下载完整依赖包 + 生成可离线识别的仓库索引。
- 用
composer install --no-scripts --no-autoloader在联网机跑一次，确保vendor/和composer.lock齐全 - 执行
composer archive --format=zip --dir=./packages（需先composer global require "hirak/prestissimo:^0.4"启用并行下载，再配合composer config --global repo.packagist composer https://packagist.org确保源一致） - 把整个
vendor/目录 +composer.lock+ 生成的packages/压缩包一并拷到离线机
用 composer config repositories 指向本地 zip 包目录
Composer 支持将本地文件夹伪装成 Composer 仓库，但只认特定结构：每个包必须是独立子目录，内含 composer.json 和压缩包（命名需匹配 vendor/name-version.zip）。手动整理太容易出错。
推荐用 toran-proxy 的轻量替代方案：composer-satis。它能把 composer.lock 里所有包一键打包并生成静态 packages.json。
- 在联网机运行：
composer create-project composer/satis:dev-main satis --stability=dev --no-interaction - 写一个
satis.json，关键字段：{"name": "local-mirror", "homepage": "file:///path/to/mirror", "repositories": [{"type": "composer", "url": "https://packagist.org"}], "require-all": true} - 执行
php bin/satis build satis.json ./mirror，生成的mirror/就是可离线使用的本地仓库 - 离线机执行：
composer config repositories.local-mirror composer file:///path/to/mirror
composer update 在离线环境为何仍会报 DNS 错误
即使配置了本地仓库，composer update 仍可能触发对 packagist.org 的元数据请求——因为 Composer 默认开启 packagist.org 的“fallback”机制，只要本地仓库没覆盖某个包的某个版本，它就自动回源查询。
必须彻底禁用远程源。不是删掉 repositories 配置，而是显式关闭 fallback：
- 执行
composer config repos.packagist false（注意不是packagist.org） - 确认
composer config --list | grep repos输出中repos.packagist值为false - 如果项目
composer.json里写了"repositories": [{"type": "packagist", "url": "https://packagist.org"}]，必须手动删掉这一段 - 再次运行
composer update --no-plugins --no-scripts，此时所有解析都只走本地packages.json
离线部署后 autoload 失效或类找不到
常见错觉是“包装进来了，类就该能用”，但 Composer 的自动加载依赖 vendor/autoload.php 生成时的路径快照。如果离线机的项目路径和联网机不一致（比如从 /home/user/project 拷到 D:\project），vendor/composer/autoload_static.php 里的绝对路径就会失效。
解决方案只有一个：在离线机上重新生成 autoloader，且不联网：
- 确保
vendor/已存在、composer.lock已就位 - 执行
composer dump-autoload --optimize --classmap-authoritative - 如果提示
Class not found，说明某些包的autoload配置依赖动态扫描（如"psr-4": {"": "src/"}），此时必须保证src/目录结构与composer.lock记录的一致
最稳的做法：所有离线部署，都在目标环境的最终路径下执行一遍 composer install --no-dev --prefer-dist，哪怕 vendor 已存在——它只会校验哈希、重建 autoload，不碰网络。
