离线安装vendor目录必须提前归档而非直接复制，因vendor缺少autoload文件和初始化逻辑；需在有网机执行composer install --no-dev --prefer-dist后用composer archive打包完整项目，目标机用composer install --no-interaction等命令还原。
离线安装 vendor 目录必须提前做「包归档」，不是复制 vendor 就能复用
Composer 本身不支持“直接离线 install”，composer install 在无网络时会立即报错 Could not fetch packages。真正可行的离线方案，是把依赖包的完整分发态（含源码、autoload 映射、版本锁定）打包带走，而非只拷贝 vendor/ 目录——因为 vendor/ 中的包可能缺失 composer.json、autoload.php 初始化逻辑，或依赖本地生成的 vendor/composer/autoload_*.php 文件，这些在新环境未执行 install 前根本不存在。
关键动作有两步：在有网机器上运行 composer install --no-dev --prefer-dist，再用 composer archive 或手动打包整个项目（含 vendor/ + composer.lock + composer.json）；目标机无需 Composer 运行环境，但需 PHP 可执行且扩展兼容。
用 composer archive 打包比手动 zip 更可靠
composer archive 会按 composer.lock 精确导出每个包的 dist 包（.zip/.tar.gz），并保留版本哈希与 autoload 结构，避免手动复制时遗漏 vendor/composer/ 下的自动加载文件或插件脚本。
- 执行前确保已运行过
composer install，使vendor/和composer.lock同步 - 命令示例：
composer archive --format=zip --dir=./dist myapp-1.0，会生成dist/myapp-1.0.zip - 生成的 zip 内含完整
vendor/、composer.json、composer.lock，解压后可直接部署 - 注意：该命令不会打包
node_modules或.env，敏感文件需单独处理
离线机还原时跳过网络校验，但必须校验 composer.lock 完整性
目标机器即使无网，只要 PHP 环境就绪，仍可运行 composer install --no-interaction --no-plugins --no-scripts 强制从本地 vendor/ 和 composer.lock 构建 autoload。但前提是：composer.lock 文件不能损坏，且其 content-hash 必须与当前 composer.json 匹配，否则会提示 The lock file does not contain require-dev information 或拒绝继续。
- 检查方式：
composer validate --strict（可在有网机提前验证） - 若
composer.lock被意外修改，需重新生成：先删掉vendor/和composer.lock，再用原始composer.json运行composer install --no-dev --prefer-dist - 禁止在离线机上运行
composer update，它必然失败且可能污染composer.lock
长期离线维护建议用 packagist-mirror + composer config 切换源
如果多个项目需频繁离线部署，手动归档太重。更可持续的做法是在局域网搭一个 Packagist 镜像（如用 igorw/packagist-mirror），然后在开发机统一配置：
composer config -g repos.packagist composer https://your-mirror.example.com
之后所有 composer install 默认走内网镜像，composer.lock 记录的仍是标准包名和版本，迁移时只需同步镜像数据 + 项目目录即可。这种方式规避了归档/解压的体积与一致性风险，但首次搭建需额外运维成本。
最易被忽略的一点：vendor/ 目录里的某些包（如含 bin/ 脚本或 resources/ 的扩展）可能硬编码了绝对路径或依赖构建时的环境变量，这类包离线迁移后需人工验证行为是否一致——不能只看 autoload 是否正常。
