在 composer.json 中为 autoload 配置多个命名空间路径，应使用 "psr-4" 字段定义关联数组，键为带双反斜杠的命名空间前缀（如 "App\\"），值为对应源码路径；支持单路径或数组形式的多路径映射，并可通过 "autoload-dev" 分离开发专用命名空间。
在 composer.json 中为 autoload 配置多个命名空间路径，核心是使用 "psr-4"（推荐）或 "psr-0" 字段，将不同命名空间映射到各自对应的源码目录。Composer 会按顺序读取这些映射，并支持同一项目中多个命名空间共存。
使用 psr-4 配置多个命名空间
psr-4 是当前标准做法，结构清晰、性能好，且自动忽略非命名空间文件。只需在 "autoload" 下的 "psr-4" 键中写入一个关联数组，每个键是带结尾反斜杠的命名空间前缀，值是相对于项目根目录的路径（可为数组，支持多路径）：
{
"autoload": {
"psr-4": {
"App\\": "src/",
"Tests\\": "tests/",
"Vendor\\Package\\": ["lib/", "vendor-src/"]
}
}
}
说明：
-
"App\\"→ 所有以App\开头的类，从src/下查找（如App\Http\Controller对应src/Http/Controller.php） -
"Tests\\"→ 映射到tests/，适合放测试用例类 - 一个命名空间可对应多个路径：如
"Vendor\\Package\\"同时扫描lib/和vendor-src/，Composer 会按顺序查找，先命中即停
区分开发与生产环境的自动加载
若某些命名空间仅用于开发（如测试工具、命令行脚本），应放在 "autoload-dev" 中，避免发布时被误引入：
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"App\\Tests\\": "tests/",
"App\\Console\\": "console/"
}
}
}
执行 composer install --no-dev 或部署时，autoload-dev 的配置会被忽略，不影响生产环境 autoload 映射。
注意事项与常见问题
配置后必须运行 composer dump-autoload（或 install/update）才能生效，否则 autoloader 不识别新路径。
- 命名空间末尾必须加双反斜杠（
"App\\"），这是 PSR-4 强制要求，漏掉会导致匹配失败 - 路径需存在且可读；若路径为空或不存在，Composer 不报错但类无法加载
- 避免命名空间重叠（如同时定义
"App\\"和"App\\Http\\"），后者会被前者覆盖或引发不可预期行为 - 如需兼容老项目，可用
"psr-0"，但不推荐新项目使用（已逐步被弃用）
验证配置是否生效
运行以下命令检查生成的 autoload 映射是否符合预期：
composer dump-autoload -o && composer show -s
也可临时写个测试脚本：
如果返回 false，检查命名空间拼写、文件路径、大小写一致性（Linux 下敏感）以及是否执行了 dump-autoload。
