PSR-4 生效需在 composer.json 的 "autoload" 中正确定义命名空间前缀与目录映射，如 "App\": "src/"，路径须以 / 结尾、双反斜杠转义，修改后运行 composer dump-autoload。
composer.json 里 psr-4 怎么写才生效
PSR-4 自动加载不会自动猜路径，必须手动在 composer.json 的 "autoload" 下明确声明命名空间前缀与物理目录的映射关系。写错一个斜杠、少一个反斜杠、路径没加末尾 /，都会导致 class not found。
常见错误现象：Class AppControllersHomeController not found，但文件明明在 src/Controllers/HomeController.php；或者 vendor/autoload.php 已引入，类却始终不被识别。
-
"App\"后面必须跟两个反斜杠（PHP 字符串转义），实际表示命名空间分隔符 - 目录路径是相对于
composer.json所在位置的相对路径，且必须以/结尾（如"src/"，不是"src"） - 命名空间前缀不能是空字符串，也不能用
\开头（如"\App\"是错的） - 修改后必须运行
composer dump-autoload（或composer install/update）才能更新vendor/composer/autoload_psr4.php
正确示例：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
为什么 vendor/autoload.php 引入后类还是找不到
引入 vendor/autoload.php 只是加载 Composer 生成的自动加载器，它是否能定位到你的类，完全取决于 autoload_psr4.php 里有没有对应映射，以及文件路径是否严格符合 PSR-4 规则。
使用场景：你在 index.php 中写了 require __DIR__ . '/vendor/autoload.php';，但调用 new AppControllersHomeController() 仍报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查文件路径是否与命名空间完全对齐：命名空间
AppControllers→ 目录必须是src/Controllers/（注意大小写，Linux 下敏感） - 确认类文件名是
HomeController.php，且内部声明为namespace AppControllers;（不能多空格、不能用 tab 缩进 namespace 行） - 运行
composer dump-autoload -o查看是否报路径不存在警告；如果提示Directory does not exist，说明配置里的路径写错了 - 临时加一句
var_dump(include 'vendor/composer/autoload_psr4.php');，直接看数组里有没有你配的键值对
多个 PSR-4 命名空间怎么共存
可以同时定义多个映射，但要注意优先级和路径覆盖风险。Composer 按 JSON 键顺序读取，但实际匹配时是“最长前缀优先”，所以更具体的前缀要放在前面，否则可能被宽泛前缀截胡。
参数差异：每个映射都是独立的 "命名空间前缀" => "目录" 对，彼此不继承、不拼接。
- 错误写法：
"App\" => "src/"和"App\Tests\" => "tests/"—— 后者永远不会命中，因为App\已匹配所有以App开头的类，包括AppTests* - 正确顺序：
"App\Tests\" => "tests/"必须写在"App\" => "src/"前面 - 测试类建议单独用
"autoload-dev"，避免发布时带上测试代码："autoload-dev": { "psr-4": { "App\Tests\": "tests/" } } - 第三方包的 PSR-4 映射由它们自己的
composer.json定义，无需你手动配置
PSR-4 和 classmap / files 的区别在哪
PSR-4 是按规则推导路径，适合结构清晰的项目；classmap 是扫描生成静态路径表，适合散装类或无法改路径的老代码；files 是直接 require 全局函数文件，和类无关。
性能影响：PSR-4 在首次使用类时实时拼路径，有轻微开销但可忽略；classmap 生成后是纯数组查找，稍快，但每次增删文件都要重新 dump-autoload；files 每次加载自动加载器就会执行，不管用不用得到。
- 别用
classmap替代 PSR-4 来“偷懒”——它不会帮你解决命名空间问题，只是绕过它 -
files里写的文件路径也必须存在，否则composer dump-autoload会警告并跳过 - 混合使用时，PSR-4 匹配失败才会 fallback 到
classmap，再失败才查files（仅限函数） - 调试时可用
composer show --platform看当前加载了哪些自动加载机制
最常被忽略的是：PSR-4 要求文件路径和命名空间严格一一对应，差一个字母、多一个下划线、大小写不一致，在 Linux 或 Docker 环境里直接失效，而开发机（macOS/Windows）可能因文件系统不区分大小写而“碰巧”跑通。
