Composer需运行dump-autoload生效；PSR-4要求命名空间与目录严格对应，如"App\": "src/"；classmap适用于无命名空间的老代码；files用于全局函数/常量文件。
Composer 默认不会自动加载你写的类，除非你明确告诉它哪些目录、命名空间或文件需要被纳入自动加载机制。直接改 composer.json 的 autoload 字段就能生效，不需要手写 require 或修改 vendor/autoload.php。
如何用 psr-4 加载自定义命名空间类
这是最常用也最推荐的方式，适合有稳定命名空间结构的项目（比如 App\\、Lib\\）。
-
psr-4要求目录结构与命名空间严格对应，例如App\\Controller\\Home必须在src/Controller/Home.php - 在
composer.json中配置：{ "autoload": { "psr-4": { "App\\": "src/" } } } - 运行
composer dump-autoload（开发中可加-o生成优化版，但调试阶段建议不用） - 注意：如果
src/下还有子目录如src/App/，而命名空间却是App\\，就会加载失败——路径是相对于"App\\": "src/"的，不是相对于项目根目录
什么时候该用 classmap 而不是 psr-4
当你有一批老代码、无命名空间、文件名不遵循 PSR-4 规范，或者类名和文件名不一致时，classmap 是更务实的选择。
-
classmap不依赖命名空间或文件名规则，只扫描指定路径下所有.php文件并建立类名 → 文件路径映射 - 配置示例：
{ "autoload": { "classmap": ["legacy/", "utils/helpers.php"] } } - 执行
composer dump-autoload后，Composer 会递归扫描legacy/目录并生成映射表 - 缺点：新增类文件后必须重新运行
dump-autoload，否则不会被加载；且无法支持命名空间别名或动态前缀
files 加载全局函数或常量定义文件
适用于没有类、只有函数或 define() 的辅助文件，比如 helpers.php 或 constants.php。
- 这些文件会在每次请求时被无条件
require_once，和自动加载机制无关，所以不能用于类定义（会报重复定义） - 配置方式：
{ "autoload": { "files": ["src/functions.php", "config/constants.php"] } } - 注意：路径是相对于
composer.json所在位置的，不是相对于vendor/autoload.php - 如果多个包都用了
files，加载顺序由 Composer 内部决定，不可控；有依赖关系时建议改用classmap或封装成类
真正容易出问题的不是配错字段，而是没理解「autoload 配置只影响 composer dump-autoload 生成的映射」——改完 composer.json 不运行这命令，什么都不会发生；另外，生产环境若用了 composer install --no-dev，而你的 autoload 配置写在 autoload-dev 里，那类就彻底加载不到。
