离线执行 composer create-project 失败的核心原因是其强制联网校验仓库元数据，需提前同步完整 Packagist 镜像（含 packages.json、分片文件及 dist 包），配置本地仓库路径，禁用插件与脚本，并用分步法（init + 复制 vendor + dump-autoload）替代黑盒命令，同时确保 composer.lock、vendor-dir、cache-dir 严格匹配且可写。
composer create-project 离线失败的典型表现
执行 composer create-project laravel/laravel myapp 时卡在 “Loading composer repositories”，或报错 Could not fetch https://repo.packagist.org/packages.json —— 这不是配置问题，是 Composer 默认强制联网校验仓库元数据，哪怕本地有缓存也不走离线路径。
提前下载并固化 packagist 镜像到本地
离线可用的前提，是把 Packagist 的完整元数据（packages.json 及其分片）和所有依赖包的 zip/tar 存档提前拉下来。不能只靠 composer install --no-install 或 composer dump-autoload，那些不解决初始化源头问题。
- 在线机器上用
composer archive或第三方工具如packagist-mirror同步全量数据，重点导出：packages.json、provider-laravel~framework.json类分片文件、以及.zip包（放在dist/目录下） - 把整个镜像目录（比如
/path/to/packagist-offline）拷贝到离线机器 - 在离线机的
composer.json中显式指向本地仓库：{"repositories": [{"type": "composer", "url": "file:///path/to/packagist-offline"}]} - 必须加
--no-plugins --no-scripts，避免插件尝试联网或执行需网络的脚本
用 composer init + 手动 vendor 替代 create-project
composer create-project 是个“黑盒”命令，内部会自动跑 install、autoload dump、甚至触发 post-root-package-install 脚本 —— 这些在离线环境大概率失败。更可控的做法是跳过它，分步构造：
- 先在离线机运行
composer init，手动填包名、描述、依赖（此时不联网，只是生成空composer.json） - 把已下载好的
vendor/目录（含完整autoload.php和所有依赖代码）直接复制进来 - 运行
composer dump-autoload --classmap-authoritative，确保类映射不依赖文件扫描（否则可能漏类） - 验证：
php -r "require 'vendor/autoload.php'; echo class_exists('Illuminate\Support\Str') ? 'ok' : 'fail';"
为什么 vendor-dir 和 cache-dir 位置很关键
Composer 在离线时仍会尝试写缓存、生成锁文件、检查 vendor 目录结构。如果 vendor/ 不在默认路径，或 COMPOSER_CACHE_DIR 指向了不可写位置，会静默失败或报错 Could not write to /root/.composer/cache。
- 始终用绝对路径设
vendor-dir（在composer.json中），避免相对路径在不同工作目录下解析异常 - 离线机上提前创建好 cache 目录，并用
COMPOSER_CACHE_DIR=/path/to/local/cache环境变量锁定 -
composer.lock必须和composer.json一起带入离线环境 —— 它记录了确切版本哈希，没有它，install会拒绝继续
离线初始化最麻烦的不是命令怎么敲，而是「哪些文件算‘足够’」—— packages.json 缺一个分片、vendor 里少一个 autoload_static.php、lock 文件时间戳比 json 新……任何一项不匹配，Composer 就会放弃离线模式，转头去报错。得一个个对着 hash 校验。
