离线时 composer dump-autoload -o 能成功执行，是因为该命令仅重新生成本地类加载映射（如 autoload_classmap.php），不涉及网络请求、包下载或版本解析，前提是 vendor/autoload.php 存在、autoload 配置未修改且无动态路径。
离线时 composer dump-autoload -o 通常能成功执行，前提是项目已存在 vendor/autoload.php 且未触发远程依赖解析
为什么离线也能跑 dump-autoload -o？
这个命令本质是重新生成类加载映射（vendor/composer/autoload_classmap.php 等），不涉及包下载或版本解析——只要 vendor/ 目录完整、composer.json 没改过 autoload 配置，它就只读本地文件。
常见错误现象：Could not fetch packages.json 或 Failed to decode JSON 不是来自 dump-autoload，而是你之前没装好依赖，或者误在离线时先跑了 composer install 或 update。
-
-o（optimize）只是把 PSR-4/PSR-0 映射转成静态 classmap，不联网 - 如果
composer.json的autoload或autoload-dev有修改，必须先在线运行过install或dump-autoload，否则新配置不会生效 - 某些插件（如
hirak/prestissimo）在离线时可能报错，但这是插件自身行为，和dump-autoload无关
离线执行前必须确认的三件事
不是“能不能”，而是“有没有准备好”。漏掉任一条件，命令会失败或产出无效 autoload：
-
vendor/autoload.php文件存在且可读（说明之前成功install过） -
composer.lock和composer.json未被手动改动过 autoload 相关字段（如psr-4路径、files列表） - 没在
composer.json中使用动态值（如"$HOME/src"）或环境变量引用（${APP_ENV}），这些在离线时无法解析
遇到 Class not found 却刚跑完 dump-autoload -o 怎么办？
这说明优化后的 classmap 没覆盖到你的类——-o 只收录实际存在的文件，且严格按 composer.json 里声明的路径扫描。
- 检查类文件是否真在声明的目录下（比如写了
"App\": "src/"，但类文件在app/） -
files类型 autoload 不进 classmap，-o后仍需靠普通 require 加载，别指望它提速 - 运行
composer dump-autoload（不带-o）对比输出：如果非优化版能加载、优化版不能，基本是路径声明和物理路径不一致 - Windows 下注意大小写——
src/Controller和src/controller在 classmap 里是两个 key
最易被忽略的一点：dump-autoload -o 不校验类名与文件名是否匹配（比如 Foo.php 里定义 Bar 类），它只按路径扫描。上线前务必在同环境验证自动加载是否真实有效。
