composer autoload 本地化失败的典型表现是运行 composer install 或 dump-autoload 后仍报 class not found，根源在于 autoload 生成阶段依赖远程元数据；确保离线可用需满足三前提：存在兼容的 composer.lock、禁用联网行为（如 --no-scripts）、autoload 配置仅含合法本地路径。
composer autoload 本地化失败的典型表现
运行 composer install 或 composer dump-autoload 后，require 或 include 自定义类时仍报 Class not found；或者 vendor/autoload.php 加载后，命名空间映射完全不生效。这不是 PHP 版本问题，也不是文件权限问题，而是 autoload 生成阶段就依赖了远程元数据——比如你关掉网络后执行 composer install 直接卡在 loading package info from composer repository，那后续 autoload 根本不会生成。
确保 autoload 不依赖网络的三个硬性前提
Composer 的 autoload 本身是纯本地行为（只读 composer.json + 扫描文件路径），但默认命令会先尝试联网更新包信息或校验锁文件一致性。要跳过这一步：
- 必须已有有效的
composer.lock文件（且与composer.json兼容） - 执行时加
--no-install或用composer install --no-scripts --no-plugins --no-progress避免触发远程 fetch - 确认
composer.json中的autoload段落只含本地路径声明，不含psr-4映射到 URL、或classmap指向远程 ZIP 路径等非法写法
验证 autoload 是否真正离线可用
最直接的办法不是跑项目，而是检查生成结果是否“静态可执行”：
- 删掉
vendor/目录和composer.lock（留着composer.json），再执行composer install --no-interaction --prefer-dist --no-progress—— 如果它没报Could not fetch packages就说明本地缓存够用 - 运行
composer dump-autoload --optimize --classmap-authoritative，然后手动require 'vendor/autoload.php'并var_dump(class_exists('YourNamespacedClass')) - 留意
vendor/composer/autoload_classmap.php是否生成了完整数组 —— 如果为空或只有系统类，大概率是autoload路径配置错（比如写成"src/": "src/"而非"src/": ["src/"]）
PSR-4 映射里最容易漏掉的路径细节
composer.json 中的 psr-4 键值对，右边必须是目录路径，且结尾要有 /（不是 ，Windows 下也用正斜杠）。常见翻车点：
- 写成
"App\": "src/App"→ 缺少结尾斜杠，autoload 会忽略整个命名空间 - 写成
"App\": "./src/App/"→.在某些 Composer 版本中不被识别为相对路径起点 - 实际文件结构是
src/App/Http/Controller.php，但类声明是namespace AppHttpController，这时映射必须是"App\": "src/"，而不是"App\": "src/App/"
改完记得 composer dump-autoload -o，别信缓存。
