PSR-4配置不生效的主因是composer.json中autoload未置于顶层、命名空间缺双反斜杠、路径缺正斜杠或未执行composer dump-autoload；必须确保autoload与name、require同级，命名空间以\结尾，路径以/结尾，大小写严格匹配文件系统。
PSR-4 配置不生效，基本就是 composer.json 写错位置、命名空间结尾少反斜杠、路径没加斜杠，或者改完没跑 composer dump-autoload——它不会报错，只会静默失败。
autoload 必须是顶层键，不能嵌套在 require 或 scripts 里
Composer 只认和 name、require 并列的一级 autoload 字段。常见错误：
-
"autoload": {"psr-4": {...}}✅ 正确位置 -
"require": {"autoload": {...}}❌ 完全被忽略 -
"scripts": {"autoload": {...}}❌ 同样无效 -
"autoloader"或"auto-load"这类拼写变体 ❌ 不识别
命名空间必须以双反斜杠结尾，路径必须以正斜杠结尾
JSON 中写的是字符串，但 Composer 解析后要还原成 PHP 的命名空间前缀，所以：
-
"App\": "src/"✅ 匹配AppHttpControllersUserController -
"App": "src/"❌ 被当 PSR-0 兼容模式，2025 年起默认跳过 -
"App\": "src"❌ 拼出srcUserController.php，而不是src/UserController.php -
"App\": "/src/"❌ 绝对路径不支持，会加载失败
注意：Windows 下也必须用 /，不是 ；大小写必须和文件系统、类声明里的 namespace 逐字符一致。
多个命名空间怎么写？用数组，别用重复键名
想同时映射 App 和 Tests，不能这么写：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"autoload": {
"psr-4": {
"App\": "src/",
"Tests\": "tests/"
}
}
}
这是合法 JSON，但容易误以为“两个键并存”——实际没问题。真正危险的是把多个路径塞进同一个键下，比如：
"App\": ["src/", "app/"]
❌ 错误：PSR-4 不支持一个前缀对应多个目录，这会直接失效。正确方式是分开声明：
"App\": "src/", "Tests\": "tests/"
它们按顺序注册，互不干扰。新增后必须运行 composer dump-autoload 才生效。
classmap 是非标命名空间（如 Legacy_）的唯一出路
PSR-4 不处理下划线分隔、无命名空间、或带动态前缀（如 AppDevV2）的类。这类代码只能走 classmap：
- 在
composer.json中加："classmap": ["legacy/", "old-lib/"] - 运行
composer dump-autoload（开发）或composer dump-autoload --optimize（生产） - Composer 会扫描这些目录下所有
.php文件，提取class和interface声明，写入vendor/composer/autoload_classmap.php - ⚠️ 新增类后必须重跑
dump-autoload，否则不会被加载
PSR-4 是纯字符串替换，不扫描、不猜测、不 fallback。你写的每个反斜杠、每级目录、每个大小写，都得和实际文件结构严丝合缝——这点最容易被当成“玄学问题”反复折腾。
