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"键名必须原样拼写，不能带连字符或下划线 - 如果写成
"autoloads"、"auto_load"或缩进在require-dev下，配置就彻底被无视 - 运行
composer show --platform可确认当前 autoloader 是否已加载你的映射
PSR-4 命名空间与路径的字符串拼接规则
Composer 不扫描文件，只做确定性字符串替换：剥离前缀 → 把 替换为 / → 拼上配置路径 → 加 .php。差一个大小写、多一层、少一级，就直接放弃。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间前缀必须以双反斜杠结尾：
"App\"✅，"App"❌，"App\\"（JSON 中表示两个反斜杠）也 ❌ - 路径值必须是相对路径，且推荐以正斜杠结尾：
"src/"✅，"src"❌（易导致拼出srcMyClass.php） - 路径不能以
/开头（如"/src/"），也不能用../或绝对路径 -
namespace AppHttpControllers;→ 对应目录必须是src/Http/Controllers/（注意大小写，http≠Http） - 类
class HomeController→ 文件必须叫HomeController.php，不能是homecontroller.php或Controller.php
改完 composer.json 后必须手动运行 composer dump-autoload
vendor/autoload.php 只是注册加载器，真正起作用的是 vendor/composer/autoload_psr4.php——这个文件不会自动更新，必须靠命令重写。
- 开发阶段用
composer dump-autoload（不加-o），能暴露路径错误；加了-o会生成 classmap，跳过运行时路径检查，反而掩盖问题 -
composer install或update仅在锁文件变更时触发 dump，日常改autoload配置仍需手动执行 - 运行后可直接检查：
var_dump(include 'vendor/composer/autoload_psr4.php');，确认数组里有没有你配的"App\" => ["src/"] - CI/CD 部署时建议加
--no-dev，避免autoload-dev里的测试类混入生产环境
部署时 --optimize-autoloader 必须配合 --no-dev 才真正生效
本地开发因默认双模式加载器而无感，生产环境启用纯 classmap 模式可提速 20%–50%，CI/CD 漏 --no-dev 等于白优化。
- 不加
--no-dev：classmap生成了，但被忽略，类仍按 PSR-4 规则实时查找路径 - 加了
--no-dev：加载器只读autoload_classmap.php，速度提升明显 - 优化后报错信息会变弱——原本提示 “tried loading
src/Http/Controllers/HomeController.phpbut file not found”，而 classmap 模式只报 “Class not found” - 部署前务必确认：
vendor/composer/autoload_classmap.php里是否真有你要的类路径（搜索类名即可）
最易被忽略的一点：PSR-4 是静态查表，不是运行时推断。哪怕你删了整个 src/ 目录，只要 autoload_psr4.php 里还存着映射，加载器仍会尝试去那个路径找——只是最后报 file not found 而已。
