Composer install仅生成vendor/autoload.php，不会自动加载它；必须在入口文件顶部手动require该文件，且路径需正确（如public下用../vendor/autoload.php），否则类无法加载。

composer install 会生成 vendor/autoload.php，但不会自动加载它

很多人以为 composer install 执行完，项目就能直接用类了——其实它只负责生成 vendor/autoload.php 文件，是否加载、何时加载、加载后是否生效，完全取决于你自己的引导文件（比如 index.php 或 public/index.php）里有没有那一行 require 'vendor/autoload.php';。

常见错误现象：运行 composer install 成功，但访问页面报 Class 'AppHttpControllerHomeController' not found ——根本不是依赖没装，而是引导文件漏了 autoload 引入。

• 必须手动在项目入口文件顶部添加 require 'vendor/autoload.php';，且位置要早于任何类使用
• 路径必须写对：vendor/autoload.php 是相对于当前脚本所在目录的，不是相对于项目根目录；如果入口在 public/ 下，就得写 require '../vendor/autoload.php';
• 不要用 include 替代 require：autoload 加载失败时必须中止，否则后续类找不到会静默失败或报错偏移

autoload 配置变更后，install 不会自动重生成 autoload.php

composer install 只在安装/更新依赖时触发 autoload 文件重建，它不感知 composer.json 里 autoload 块的修改。改完 PSR-4 映射或 classmap 路径后直接跑 composer install，vendor/autoload.php 里的映射还是旧的。

典型场景：把 "App\": "app/" 改成 "App\": "src/"，然后执行 composer install，结果类依然从 app/ 下找 —— 因为 autoload 没刷新。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 必须显式执行 composer dump-autoload 才能更新 vendor/autoload.php
• 加 -o 参数（composer dump-autoload -o）只优化已有映射，不重建 classmap；真正要扫新路径，得用 composer install --optimize-autoloader 或先删掉 vendor/composer/autoload_classmap.php 再 dump
• CI/CD 中建议把 composer install --optimize-autoloader 和 composer dump-autoload 分开写清楚，避免误以为 install 已包含 autoload 刷新

install 时 --no-dev 对 autoload.php 的实际影响很小

composer install --no-dev 确实跳过安装 require-dev 里的包，但它**不屏蔽 autoload-dev 的加载规则**。只要 vendor/autoload.php 存在，里面就同时包含 autoload 和 autoload-dev 的映射 —— 生产环境照样会尝试加载 tests/ 目录下的类。

后果很直接：某处代码不小心 use AppTestsExampleTest;，本地没问题，上线就报 Class not found，因为 tests/ 根本没被部署过去。

• 安全做法是彻底从 autoload 和 autoload-dev 中移除 tests/ 目录，让 PHPUnit 自己管理测试类加载
• 检查 vendor/autoload.php 里是否含 'AppTests' => array($vendorDir . '/myproject/tests') 这类映射，有就说明风险存在
• 生产部署前可用 php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppTestsExampleTest'));" 快速验证

vendor/autoload.php 的加载时机决定类是否可用

PHP 是单次请求生命周期模型，vendor/autoload.php 只在被 require 的那一刻初始化一次。它内部注册的是 SPL autoloader，后续所有 new、use、class_exists() 都靠这个机制触发。

容易被忽略的点：某些框架（如 Laravel）会在启动时调用 ClassLoader::addPsr4() 动态追加映射，这会覆盖或干扰 Composer 生成的静态映射 —— 尤其当你启用了 --classmap-authoritative，而框架又动态加了路径，就会导致“类明明存在却找不到”。

• 确认 vendor/autoload.php 是否被多次 require：重复引入不会报错，但会重注册 autoloader，可能引发优先级混乱
• 用 get_declared_classes() 或 spl_autoload_functions() 在关键位置 dump，看 autoloader 注册状态
• 若用 --classmap-authoritative，确保所有类文件都在 autoload 声明路径内，框架 patch 行为需额外适配

autoload.php 不是魔法开关，它是一份静态注册表，生效与否，全看你什么时候 require、怎么配置、有没有被其他逻辑覆盖。最常出问题的地方，从来不是 install 命令本身，而是它生成的文件，被你或框架悄悄绕过了。