Composer支持同时配置psr-4、psr-0、classmap和files四类autoload规则，按声明顺序合并生效；psr-4多路径需用数组表示，命名空间不可嵌套，路径须为相对路径且不以斜杠结尾。
composer.json 里怎么写多个 autoload 配置项
Composer 支持在同一项目中同时配置 "psr-4"、"psr-0"、"classmap" 和 "files" 四类自动加载规则，它们会按声明顺序合并生效，不存在覆盖关系。关键不是“能不能加多个”，而是“加在哪、怎么组织才不冲突”。
常见错误是把不同路径的 PSR-4 映射硬塞进同一个数组键下，导致后写的被前写的覆盖（因为 JSON 键名唯一）：
{
"autoload": {
"psr-4": {
"App\": "src/",
"App\": "app/" ← 这行无效：键重复，会被上一行覆盖
}
}
}
正确做法是合并到同一组映射中：
{
"autoload": {
"psr-4": {
"App\": ["src/", "app/"],
"Vendor\Tools\": "vendor-tools/src/",
"Tests\": "tests/"
}
}
}</p>
<ul>
<li><code>psr-4</code> 的值必须是数组（即使只有一条路径），多路径用列表形式表达</li>
<li>不同命名空间前缀不能互相包含（如 <code>"A\"</code> 和 <code>"A\B\"</code> 共存时，<code>A\B\X</code> 类可能被错误匹配到 <code>A\</code> 规则下）</li>
<li>路径必须是相对于 <code>composer.json</code> 所在目录的相对路径，且结尾不带斜杠（<code>"src"</code> ✅，<code>"src/"</code> ❌ 在某些旧版本会报 warning）</li>
</ul>
<H3>PSR-4 和 classmap 混用时谁优先</H3>
<p>Composer 自动加载器按注册顺序查找类：先查 <code>psr-4</code>，再查 <code>psr-0</code>，然后是 <code>classmap</code>，最后是 <code>files</code>。但实际执行中，**PSR 规则一旦命中路径就立即尝试加载文件，不会退回到 classmap**；只有 PSR 规则完全不匹配时，才会继续走 classmap。</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p>
<p>这意味着：</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/2254" title="ModelGate"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680205110116.png" alt="ModelGate" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/2254" title="ModelGate">ModelGate</a>
<p>一站式AI模型管理与调用工具</p>
</div>
<a href="/ai/2254" title="ModelGate" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<ul>
<li>如果你在 <code>psr-4</code> 中写了 <code>"Legacy\": "legacy/"</code>，又在 <code>classmap</code> 中包含了 <code>legacy/old.php</code>，那么 <code>LegacyOldClass</code> 仍会走 PSR-4 加载逻辑（即找 <code>legacy/OldClass.php</code>），不会自动 fallback 到 classmap</li>
<li>classmap 更适合加载不符合 PSR 标准的散装类、函数文件，或需要预生成映射提升性能的场景（如大型遗留模块）</li>
<li>运行 <code>composer dump-autoload -o</code> 会把所有规则合并进一个优化后的 <code>autoload_classmap.php</code>，此时加载顺序差异消失，但映射关系不变</li>
</ul>
<H3>如何让 tests 目录下的测试类也能被自动加载</H3>
<p>默认情况下，<code>tests/</code> 不参与生产环境 autoload，但 PHPUnit 运行时需要加载测试类。最稳妥的方式是单独为测试类配置 autoload（开发专用）：</p>
<pre class="brush:php;toolbar:false;">
{
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
}
注意：autoload-dev 中的规则**只在 composer install --dev（默认）或 composer update 时生效**，线上部署用 composer install --no-dev 会跳过它。
- 不要把测试类放进
autoload（主 autoload），否则生产环境也会加载，可能引发依赖或安全问题 - 如果测试类依赖某些仅 dev 下存在的包（如
phpunit/phpunit），它们的 autoloading 由各自autoload-dev管理，无需额外处理 - 某些框架（如 Laravel）约定测试类用
Tests\Feature\/Tests\Unit\前缀，这时需确保Tests\映射覆盖全部子目录
修改命名空间后 composer dump-autoload 没生效？检查这三处
改完 composer.json 后运行 composer dump-autoload 却发现类还是找不到，大概率卡在这几个地方：
- 没删掉
vendor/autoload.php引入前已存在的手动 require / include —— Composer autoloader 是懒加载，手动引入会绕过它 - PHP opcode 缓存（如 OPcache）未清除，导致旧的 autoload 文件被缓存，可临时加
opcache_reset()或重启 PHP-FPM - 类文件名大小写不一致（尤其在 Windows/macOS 开发、Linux 部署时）：PSR-4 要求严格匹配，
MyClass.php里定义MyClass✅，但myclass.php里定义MyClass❌
调试技巧：运行 composer dump-autoload -v 查看详细映射输出，或直接打开 vendor/composer/autoload_psr4.php 确认你的命名空间是否已写入。
