composer无真正离线模式，真离线必须设composer_disable_network=1并配合完整vendor目录、禁用全局repo.packagist、执行--no-plugins --no-scripts --no-autoloader及dump-autoload -o。
Composer 没有“中文镜像”这个概念，所谓“中文镜像”只是国内厂商对 repo.packagist.org 的 HTTP 代理缓存服务——它本质仍是联网行为，无法实现完全离线。真离线只有一条路：让 composer install 过程中 零 HTTP 请求。
COMPOSER_DISABLE_NETWORK=1 是硬性前提，不是可选项
不设这个环境变量，composer install 就会尝试访问 @#@#@#@#@#@#@#@#@#@0，哪怕 vendor/ 已存在、composer.lock 完整，也会卡住或报错。
-
COMPOSER_DISABLE_NETWORK=1必须在命令前生效（Linux/macOS：export COMPOSER_DISABLE_NETWORK=1；Windows：set COMPOSER_DISABLE_NETWORK=1） - 它作用于整个进程，包括插件、脚本、元数据校验环节
- 如果
composer.lock中某个包的dist.url是https://开头，且没配本地仓库，COMPOSER_DISABLE_NETWORK=1下会直接退出，不给你机会降级
验证是否生效：临时加 127.0.0.1 repo.packagist.org 到 /etc/hosts（Windows 是 %SystemRoot%\System32\drivers\etc\hosts），再跑 composer install -v，看到 Connection refused 才算到位。
离线机上不能只传 composer.lock，必须带完整 vendor/ 目录
composer.lock 只是声明“该装什么”，不是“怎么装”。离线时没有网络，composer install 不会下载，但也不会自动信任已有的 vendor/ —— 它仍要校验每个包的 dist.shasum 和路径一致性。
- 在线机执行：
composer install --no-dev --prefer-dist --optimize-autoloader - 打包前删掉：
vendor/bin/（Windows 软链失效）、vendor/composer/installed.json（含绝对路径，引发 autoload 异常） - 目标机解压后，运行：
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader - 最后必须补：
composer dump-autoload -o，否则运行时报Class not found
别信“只传 lock 文件就能重装”，也别删掉 vendor/ 再跑 install —— 那等于要求 Composer 在没 ZIP、没源、没网络的情况下凭空还原依赖。
repo.packagist 全局配置必须显式禁用或重定向
很多团队配了内网镜像却仍失败，是因为没关掉默认源。Composer 2.2+ 会硬编码访问 repo.packagist.org 获取元数据，除非显式覆盖。
- 运行：
composer config -g repo.packagist false（彻底禁用）
或：composer config -g repos.packagist '{"type":"composer","url":"@#@#@#@#@#@#@#@#@#@1"}'（指向内网 HTTP 服务） - 别只改项目级：
composer config repo.packagist对 CI/CD 和新项目无效，-g是强制项 - 验证：
composer config -g -l | grep repo，输出里应只有你设的 URL 或false
注意：file:// 协议已被 Composer 2+ 明确禁用，即使路径正确也会报 Invalid repository type: file:。
真正离线的关键不在“怎么装”，而在“不让它想联网”。所有看似绕开网络的配置（如改 hosts、换镜像源），只要没切断 COMPOSER_DISABLE_NETWORK=1 + repo.packagist 全局禁用 + vendor/ 完整性这三根线，就随时可能在某个小版本升级后突然失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
