在 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/下查找（如AppHttpController对应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
也可临时写个测试脚本：
<?php
require 'vendor/autoload.php';
var_dump(class_exists('AppHttpController')); // 应返回 true
?>
如果返回 false，检查命名空间拼写、文件路径、大小写一致性（Linux 下敏感）以及是否执行了 dump-autoload。
