PSR-4不生效主因是composer.json中autoload配置位置错误或未执行composer dump-autoload；autoload必须为顶层键，命名空间以双反斜杠结尾，路径为相对正斜杠结尾，且命名空间、目录、类名须严格大小写一致。
PSR-4 不生效，90% 是因为 composer.json 里那行配置写错了，或者改完没跑 composer dump-autoload —— 它不会自己更新，也不会报错告诉你哪错了。
composer.json 的 autoload 必须是顶层键，且格式不能错
Composer 完全忽略嵌套在 require、scripts 或拼错名（比如 autoloader）里的 autoload 配置。它只认和 name、require 并列的一级 autoload 字段。
-
"autoload"键名必须原样拼写，不能带连字符或下划线 - 命名空间前缀必须以双反斜杠结尾：
"App"✅，"App"❌，"App\"（JSON 中表示一个反斜杠）也 ❌ - 路径值必须是相对路径，且推荐以正斜杠结尾：
"src/"✅，"src"❌（易导致拼接出srcMyClass.php） - 路径不能以
/开头（如"/src/"），也不能用../或绝对路径
命名空间、目录结构、类名三者必须逐字符对齐
Composer 不扫描文件，只做字符串替换：剥离前缀后，把剩余命名空间段用 / 连接，再拼上配置的路径。差一个大小写、多一层、少一级，就直接放弃。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
namespace AppHttpControllers;→ 对应目录必须是src/Http/Controllers/（注意大小写，http≠Http） - 类
class HomeController→ 文件必须叫HomeController.php，不能是homecontroller.php或Controller.php - 文件必须真实存在，且路径大小写完全一致；Linux/macOS 下
src/Utils/Helper.php和src/utils/helper.php是两个不同路径 -
namespace声明行不能有前导空格或 tab：namespace AppHttpControllers;✅，namespace AppHttpControllers;❌
改完 composer.json 后必须手动运行 composer dump-autoload
vendor/autoload.php 只是注册加载器，真正起作用的是 vendor/composer/autoload_psr4.php —— 这个文件不会自动更新，必须靠命令重写。
- 开发阶段用
composer dump-autoload（不加-o），能暴露路径错误；加了-o会生成 classmap，跳过运行时路径检查，反而掩盖问题 - 运行后可直接检查：
var_dump(include 'vendor/composer/autoload_psr4.php');，确认数组里有没有你配的"App" => ["src/"] -
composer install或update仅在锁文件变更时触发 dump，日常改 autoload 配置仍需手动执行 - CI/CD 部署时建议加
--no-dev，避免autoload-dev里的测试类混入生产环境
多个 PSR-4 映射共存时要注意前缀覆盖
你可以为不同命名空间指定不同源目录，但 Composer 按前缀长度降序匹配，长前缀优先。一旦短前缀先命中，更长的就不会被尝试。
- 允许共存：
"App" → "src/"和"Tests" → "tests/" - 危险组合：
"AppHelper" → "src/Helper/"和"AppHelperUtils" → "src/Helper/Utils/"—— 后者永远无法命中，因为AppHelper已先匹配到src/Helper/ - 前缀顺序在 JSON 中无关紧要，Composer 内部自动排序
- 空字符串
""作为前缀虽语法合法，但会覆盖Exception、PDO等全局类，禁止使用
最常被忽略的点是：你以为改完 composer.json 就好了，其实 autoload_psr4.php 里根本没你的映射；或者你用 -o 跑了一次，之后新增类却忘了再 dump，结果类就“凭空消失”了。
