Composer自动加载需配置composer.json的autoload段并执行composer dump-autoload；PSR-4映射如"App\": "src/"要求命名空间与目录严格对应，files用于全局函数，classmap适用于无命名空间旧代码，autoload-dev专管测试类且仅在dev环境生效。
Composer 默认不会自动加载你写的类，除非你明确告诉它“这些文件该用什么规则去加载”。最直接有效的方式是配置 autoload 字段，而不是靠手动 require 或写一堆 use 前缀来硬凑。
composer.json 里怎么写 autoload（PSR-4 最常用）
绝大多数现代 PHP 项目都用 PSR-4 —— 它把命名空间映射到目录，让 new AppServicesUserService() 自动对应到 src/Services/UserService.php。
在 composer.json 中加这段：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
注意几个关键点：
-
App\后面的双反斜杠是必须的，PHP 命名空间末尾要带\，否则 Composer 会当成前缀匹配而非完整命名空间前缀 -
src/路径是相对于composer.json所在目录的，不能写成./src/或src（少斜杠可能在某些系统下失败） - 改完后必须运行
composer dump-autoload，否则新配置不生效；开发中可加-o参数生成优化后的类映射：composer dump-autoload -o
需要加载单个文件（比如 helpers.php）怎么办
PSR-4 不适合加载全局函数或定义常量的文件。这时候要用 files 类型，它会在每次 autoload 初始化时无条件 include 这些脚本。
示例：加载 src/helpers.php
{
"autoload": {
"psr-4": { "App\": "src/" },
"files": ["src/helpers.php"]
}
}
常见踩坑：
-
files列表里的路径也必须是相对composer.json的，且文件必须真实存在，否则composer install会报错并中断 - 不要把
config.php或含exit/die的脚本放进去，它们会在 Composer 自动加载阶段执行，容易导致 CLI 命令意外退出 - 多个文件按需加载顺序写在数组里，前面的先执行，依赖关系得自己理清
旧项目用 classmap 怎么配（兼容非标准结构）
如果你的类没按命名空间组织，或者散落在不同目录（比如 lib/、includes/），classmap 是兜底方案：Composer 会扫描指定路径下所有 .php 文件，提取 class 和 interface 声明，生成静态映射表。
配置方式：
{
"autoload": {
"classmap": ["lib/", "includes/"]
}
}
使用前提和限制：
- 必须运行
composer dump-autoload才能重新扫描——新增类文件后不执行这步，类就“看不见” - 不支持命名空间推导，
class SomeUtil就只能用new SomeUtil()，不能靠命名空间自动定位 - 扫描过程有性能开销，大项目慎用；生产环境建议加
-o生成优化映射，避免每次请求都遍历目录
autoload-dev 和测试类怎么隔离
测试代码（如 tests/ 下的 PHPUnit 类）不该被生产环境加载，否则可能暴露调试逻辑或拖慢响应。Composer 提供 autoload-dev 专门处理这类场景。
典型配置：
{
"autoload": {
"psr-4": { "App\": "src/" }
},
"autoload-dev": {
"psr-4": { "App\Tests\": "tests/" }
}
}
关键行为：
-
autoload-dev的内容只在composer install --dev（默认）或composer update时写入自动加载器；用--no-dev安装时，这些映射完全不生成 - 即使映射存在，
vendor/autoload.php在运行时仍会加载全部注册项；但只要你不在生产代码里use AppTests...，就不会触发实际加载 - 别把
autoload-dev当权限控制用——它不阻止文件被 require，只是不自动注册命名空间
真正容易被忽略的是：所有 autoload 配置变更后，vendor/autoload.php 不会自动更新，必须显式运行 composer dump-autoload；而很多人改完 composer.json 就直接跑代码，结果类找不到还去查命名空间拼写，其实只是加载器没刷新。
