Composer离线使用关键是完整迁移vendor目录并确保自动加载器正确定位：需在源环境执行composer install --no-dev --optimize-autoloader，迁移时同步vendor/、composer.lock和autoload.php，并在入口文件中显式指定vendor路径。
Composer 打包离线使用，本质不是“打包”，而是确保 vendor 目录可完整迁移 + 自动加载器能正确定位。只要满足这两点，离线环境就能正常运行——不需要重新 composer install，也不依赖网络或 Packagist。
vendor 目录迁移前必须执行 composer install --no-dev --optimize-autoloader
这是最关键的一步。不加这些参数，迁移后极大概率报 Class not found 或加载缓慢：
-
--no-dev：排除require-dev中的包（如 PHPUnit、phpstan），减小体积，避免离线环境因缺失 dev 依赖而意外触发 autoload fallback -
--optimize-autoloader：生成扁平化的vendor/composer/autoload_classmap.php，把所有类路径预编译进一张表，绕过 PSR-4 的文件系统遍历——这对无 symlink、无 opcache 的离线环境尤其重要 - 务必在源环境（即开发机）执行，且确认
composer.lock已提交并一致；迁移时必须同时带走vendor/、composer.lock和autoload.php
修改自动加载路径只需改一行 require，别碰 vendor/autoload.php 本身
如果目标机器的项目路径和开发机不同（比如从 /home/user/project 迁到 /opt/app），vendor/autoload.php 里硬编码的相对路径会失效。但你**不需要重写 autoload.php**，只需在项目入口（如 index.php）中调整引入方式：
require __DIR__ . '/vendor/autoload.php';
→ 改为显式指定 vendor 路径：
require '/opt/app/vendor/autoload.php';
或者更健壮地用常量控制：
define('VENDOR_PATH', '/opt/app/vendor');
require VENDOR_PATH . '/autoload.php';
注意：vendor/autoload.php 内部依赖 vendor/composer/autoload_real.php，后者又依赖 vendor/composer/autoload_static.php 等，它们全部基于 __DIR__ 构建路径——所以直接改入口 require 是最安全、侵入性最小的做法。
离线部署后验证 autoload 是否生效：用 composer dump-autoload --classmap-authoritative 补救
如果迁移后仍遇到类找不到，先别删 vendor 重装。在离线机器上（无需联网）运行：
php composer.phar dump-autoload --classmap-authoritative
这个命令的作用是：
- 强制重建
vendor/composer/autoload_classmap.php，忽略 PSR-4 声明，只信任 classmap - 适用于 vendor 目录权限异常、文件丢失但核心类仍在的情况
- 要求原始
composer.json和composer.lock仍在项目根目录
⚠️ 注意：此操作不会下载任何包，纯本地文件分析，完全离线可行。
真正容易被忽略的是 autoload 的“信任链”：从入口 require 开始，到 autoload.php → autoload_real.php → autoload_static.php 或 autoload_classmap.php，每层都依赖上一层传入的 $vendorDir。只要第一处 require 指对了位置，后面全链路就稳了——别试图 patch vendor 里的文件，改入口最省事也最可靠。
