Composer自动加载依赖正确配置autoload字段并执行dump-autoload，常见Class not found因路径、命名空间、映射三者未对齐；推荐PSR-4，仅遗留无命名空间或非标准后缀时用classmap；测试类需配autoload-dev；vendor/autoload.php可安全多次require。
Composer 自动加载公共类不是靠“开启某个开关”，而是通过正确配置 autoload 字段并执行 composer dump-autoload 生效。配错路径、命名空间或未规范类文件结构，都会导致 Class not found 错误。
为什么 new MyHelper() 报 Class not found？
根本原因通常是三者之一没对齐：类文件的物理路径、类声明的 namespace、composer.json 中 autoload 的映射规则。Composer 不会扫描整个项目找类，它只按配置“信任”特定目录下的命名空间。
- 检查类文件是否在
src/或lib/等你声明的 autoload 目录下（例如src/Utils/MyHelper.php） - 打开该文件，确认顶部有匹配的
namespace Utils;（注意末尾无斜杠） - 确认
composer.json里写了"psr-4": { "Utils\": "src/Utils/" }，而不是"Utils/": "src/Utils/"（反斜杠必须双写） - 修改配置后必须运行
composer dump-autoload，仅composer install不会重生成自动加载映射
用 PSR-4 还是 classmap？
绝大多数情况选 psr-4：它轻量、可扩展、支持子命名空间，且符合现代 PHP 项目惯例。只有两类场景才考虑 classmap：
- 遗留代码没有命名空间，比如一堆
function xxx()+class OldUtil混在legacy/目录下 - 需要加载非标准后缀的类文件（如
.inc），而你又不愿改后缀 -
classmap需手动刷新：composer dump-autoload -o（加-o才会重新扫描）；而psr-4下新增类文件后无需任何操作，只要路径和命名空间匹配即可
如何让 tests/ 目录里的类也能被自动加载？
默认 autoload 只影响生产环境，autoload-dev 才管测试代码。直接在 composer.json 中添加：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
这样 phpunit 运行时就能找到 TestsUnitMyHelperTest。注意：这些类不会被 composer install --no-dev 加载，也不会打进生产包——这是预期行为，不是 bug。
vendor/autoload.php 被 require 多次会怎样？
不会报错，但浪费性能。Composer 的 autoloader 是单例设计，第二次 require 'vendor/autoload.php' 实际什么也不做。真正要警惕的是在循环或高频调用路径中重复 include 它——虽然安全，但没必要。一个项目入口（如 index.php 或测试 bootstrap）require 一次足矣。
最常被忽略的一点：如果你把类文件放在 autoload 声明的目录之外（比如误放到了 app/），哪怕命名空间完全正确，Composer 也永远找不到它——它不猜路径，只认配置。
