composer install 离线失败是因为默认联网校验 composer.lock 中的哈希与版本约束，需用 --no-network 参数禁用网络请求，并确保 lock 文件含完整 dist.shasum、vendor 目录存在且 php 环境兼容。
composer install 为什么离线会失败
因为默认行为会访问 packagist.org 拉取包元数据，即使本地有 vendor/，composer install 仍尝试联网校验 lock 文件里的哈希和版本约束。没网就卡在 Reading composer.json of vendor/package (dev-main) 或直接报 Could not fetch https://repo.packagist.org/packages.json。
- 必须提前在有网环境跑过完整
composer install或composer update，生成完整的vendor/和有效的composer.lock -
composer.lock里得包含每个包的dist.shasum和source.reference，否则离线时无法跳过校验 - 别用
--no-install或只保留composer.json就断网——那等于没准备
离线运行 install 的正确命令组合
核心是告诉 Composer：别联网、别查 repo、只信本地文件。靠两个关键参数压制网络行为：
- 加
--no-network：禁止所有 HTTP 请求，包括 repo 元数据、包 zip 下载、GitHub API 调用 - 加
--ignore-platform-reqs（可选）：如果离线机器 PHP 版本/扩展和开发机不一致，避免因平台约束失败 - 不要加
--update-with-dependencies或任何带update的选项——那会强行联网刷新依赖树
最终命令就是：composer install --no-network。它会跳过所有远程请求，直接读 composer.lock，校验 vendor/ 里每个包的 dist.shasum，然后生成 vendor/autoload.php 和类映射文件。
autoload.php 生成失败的常见原因
即使加了 --no-network，vendor/autoload.php 仍可能不存在或不生效，问题通常出在：
采用三层架构开发，前台集成了产品在线展示，用户注册、在线调查、在线投稿后台有类别管理\图书管理\订单管理\会员管理\配送范围管理\邮件列表\广告管理\友情链接管理等后台添加图书时自动生成缩略图和文字水印主要参考了petshop的设计架构、使用了Asp.net2.0中很多MemberShip、master等新功能后台管理地址/web/admin/ 超级管理员账号密码均为aspx1特别提示：该系统需要
-
vendor/composer/autoload_*.php文件缺失——说明之前没成功执行过 install，或被手动删了vendor/composer/目录 -
composer.lock里某个包的dist.shasum字段为空或为null——这种 lock 文件是半截产物，离线时无法验证，Composer 会拒绝继续 - 用了
path类型仓库且指向本地目录，但该目录在离线机器上不存在或路径不对——Composer 会静默跳过，导致 autoload 里缺类
检查方法：ls -l vendor/composer/autoload_*.php；再看 composer.lock 里任意一个包的 dist 块是否含 "shasum": "xxx"。
PHP 版本和扩展兼容性陷阱
离线环境 PHP 版本比生成 composer.lock 时低，或缺了某些扩展（比如 ext-zip），会导致 autoload 文件生成中途退出，但错误可能藏在日志里不显眼：
-
ext-zip缺失 → 解压包失败，autoload 不生成，报错类似Class ZipArchive not found - PHP 版本低于
composer.json里config.platform.php设定值 → 即使加了--ignore-platform-reqs，某些插件（如hirak/prestissimo）仍可能崩溃 - 离线机器开了
opcache.enable=1且opcache.validate_timestamps=0→ 修改了composer.json后运行install，旧的 autoload 可能被缓存住，类找不到
最稳做法：离线前，在目标环境用相同 PHP 版本+扩展跑一次 composer install --no-network，确认 vendor/autoload.php 能 require 且不报错。
