修改 composer.json 的 autoload 配置是最直接标准的方式，推荐使用 psr-4 映射，如 "app\": "src/"，修改后需运行 composer dump-autoload 生效，注意路径大小写、目录存在性及 autoload.php 引入。
修改 composer.json 中的 autoload 配置
Composer 的命名空间映射由 composer.json 里的 autoload（运行时加载）或 autoload-dev（开发时加载）字段控制。改它，是最直接、最标准的方式。
常见写法有三种：按 PSR-4 映射目录、按 PSR-0（已过时，不推荐）、或用 classmap 扫描具体文件。现在几乎只用 PSR-4。
例如，要把 App 命名空间指向 src/ 目录：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
注意反斜杠要双写（JSON 字符串转义），路径末尾斜杠可选但建议保留，避免和子命名空间冲突。
- 如果新增一个
Helper命名空间对应lib/Helpers/，就追加一行："Helper\": "lib/Helpers/" - 修改后必须运行
composer dump-autoload，否则变更不生效；加-o参数可生成优化后的类映射（适合生产环境） - 不要在
autoload和autoload-dev中重复定义同一命名空间，否则dump-autoload会报错
composer dump-autoload 不生效？检查这些点
改完 composer.json 却发现 new AppServiceUserService() 还是报 Class not found，大概率不是配置写错了，而是缓存或路径问题。
- 确认执行命令的当前目录是项目根目录（即含
composer.json的目录），否则dump-autoload会操作错位置 - 检查
src/目录是否存在、拼写是否大小写一致（Linux/macOS 区分大小写，SRC/≠src/） - 查看生成的
vendor/autoload.php是否被正确引入——很多新手漏掉这行：require __DIR__ . '/vendor/autoload.php'; - 如果用了符号链接（如
src -> ../shared/src），确保 Composer 能穿透链接读取真实路径；某些旧版本需要加--optimize-autoloader或升级 Composer
动态添加命名空间（不改 composer.json）
极少数场景下，比如插件系统或测试中需临时注册命名空间，可以绕过 Composer 配置，直接操作自动加载器。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
获取全局自动加载器实例后调用 addPsr4()：
$loader = require __DIR__ . '/vendor/autoload.php';
$loader->addPsr4('Plugin\', __DIR__ . '/plugins/myplugin/src/');
这种方式不会写入 vendor/composer/autoload_psr4.php，只在当前请求生命周期有效。
- 必须在
require autoload.php之后立即调用，否则其他类可能已触发加载失败 - 不能替代
composer.json配置——比如 CLI 命令或队列任务另起进程时，这段代码不会自动执行 - 不支持热更新：改了目录结构后，得手动重新
addPsr4，不适合长期维护
PSR-4 与 classmap 混用的坑
有人为了“兼容旧类”在 autoload 里同时写 psr-4 和 classmap，结果发现某些类始终加载不到。
根本原因是 Composer 加载优先级：遇到类名匹配时，会先查 psr-4 映射，再查 classmap。如果 psr-4 规则过于宽泛（比如 "\": "legacy/"），就会拦截本该走 classmap 的类。
- 避免用空命名空间前缀（
"\": "..."），这是 PSR-4 禁止的写法，Composer 8+ 会直接报错 - 若必须混用，把
classmap的路径设得更具体（如"legacy/Utils/Helper.php"），并确保psr-4规则不覆盖其命名空间 - 运行
composer dump-autoload -v可看到每条规则实际生成的映射条目，方便排查冲突
真正难调试的，往往不是怎么加，而是加完谁在什么时候、以什么顺序去查——多看 vendor/composer/autoload_*.php 生成结果，比猜快得多。
