离线安装依赖最简单有效的方式是直接复制 vendor 目录，但需确保源与目标环境的 PHP 版本、扩展、Composer 版本一致，且所有包为纯 PHP；否则易出现 Class not found 或 Extension missing 错误。

离线安装依赖前，先确认 vendor 目录是否可直接迁移

直接复制 vendor 是最简单有效的离线方案，但前提是目标环境与源环境的 PHP 版本、扩展（如 mbstring、openssl）、Composer 版本一致，且所有包都是纯 PHP（不含 post-install-cmd 编译逻辑）。否则会出现 Class not found 或 Extension missing 错误。

验证方式：在源环境运行

composer install --no-dev --optimize-autoloader

，再检查 vendor/autoload.php 是否能被正常引入；目标环境用相同 PHP SAPI（CLI/FPM）执行同一段 require 测试。

• 若项目含 ext-redis 等扩展依赖，目标机必须已安装对应扩展，否则 composer install 会跳过，但运行时崩溃
• 含 bin 脚本的包（如 phpunit）需确保目标机 php 在 $PATH 中，且路径一致
• composer.lock 必须一并拷贝，否则 vendor 中版本可能与 lock 不匹配

用 composer install --no-interaction --no-plugins 避免交互和插件干扰

即使有完整 vendor 和 composer.lock，在目标机执行 composer install 仍可能触发网络请求或插件行为（如 hirak/prestissimo、symfony/flex），导致失败或卡住。加参数可强制跳过这些环节：

composer install --no-interaction --no-plugins --no-scripts --no-dev --optimize-autoloader

关键参数说明：

• --no-interaction：禁用任何用户输入提示（比如 license 确认）
• --no-plugins：不加载任何 Composer 插件（避免插件尝试联网或写文件）
• --no-scripts：跳过 post-install-cmd 等脚本（防止执行 npm install 或生成缓存）
• --no-dev：不安装 require-dev 包，减小体积并规避 dev-only 插件

打包 vendor 时注意 .gitignore 和 .gitattributes 的影响

直接 tar -czf vendor.tgz vendor/ 可能漏掉被 .gitignore 排除但实际需要的文件，比如某些包的 dist 构建产物或 resources 目录。更稳妥的方式是使用 rsync 保留全部内容：

rsync -a --exclude='*.git' --exclude='*.log' vendor/ vendor-dist/

然后压缩 vendor-dist/。特别注意以下三类易被忽略的文件：

• vendor/bin/ 下的可执行脚本（如 phpunit、phinx），权限需保留（rsync -a 自动处理）
• vendor/composer/installed.json 和 autoload_*.php，是自动加载核心，不可缺失
• 某些包（如 laravel/framework）会在 vendor/ 外写缓存（如 bootstrap/cache/packages.php），这类不属于 vendor，不能靠打包解决

遇到 “Package x is not installed” 错误时的排查重点

该错误通常不是因为包没下载，而是 autoloader 没注册或路径错位。优先检查：

• 目标机 vendor/autoload.php 是否存在且可读（file_exists() + is_readable()）
• composer.json 中的 autoload 配置是否含相对路径（如 "files": ["src/helpers.php"]），这些路径在离线迁移后可能失效
• 是否用了 classmap 扫描（"classmap": ["src/"]），而 vendor/composer/autoload_classmap.php 没更新（此时需在源机运行 composer dump-autoload --optimize 再打包）
• PHP OPcache 是否缓存了旧的 autoloader，可临时加 opcache_reset() 或重启 PHP 进程

离线部署真正难的不是打包，而是环境一致性——PHP 小版本差一个 patch、某个扩展启用了不同编译选项，都可能导致 autoload 失败。建议把 php -v、php -m、composer --version 的输出做成校验清单，每次部署前比对。