Composer PSR-4自动加载严格按命名空间与路径映射，文件名必须与类名完全一致（含大小写），如AppServicesUserService对应src/Services/UserService.php；多段psr-4配置会覆盖而非合并，需统一收拢并避免命名空间冲突。
Composer自动加载规则不认“驼峰类名”文件路径
Composer的PSR-4自动加载机制只按命名空间和目录结构映射，完全忽略文件名是否符合类名大小写习惯。比如声明了 AppServicesUserService，它只会去 src/Services/ 下找 UserService.php，而不会接受 userservice.php 或 User_service.php —— 后者在Linux下直接报 Class not found。
常见错误现象：PHP Fatal error: Uncaught Error: Class "AppServicesUserService" not found，但文件明明存在，只是名字小写了。
- PSR-4 要求文件名必须与末级类名**完全一致（含大小写）**，包括首字母大写
- Windows开发时可能“侥幸”通过（因文件系统不区分大小写），但部署到Linux就立刻失败
- IDE自动创建类时若默认生成小写文件名（如PhpStorm旧版模板），极易埋坑
- 建议统一用
touch src/Services/UserService.php手动建文件，或配置IDE模板强制首字母大写
命名空间声明与目录路径必须严格对齐
PSR-4不是“模糊匹配”，而是字符串前缀替换：把命名空间前缀替换成对应路径，再拼上类名作为文件路径。一旦错一位，就彻底脱钩。
例如 "App": "src/" 配置下：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
AppServicesUserService→src/Services/UserService.php✅ -
AppServicesUserService+"App\": "src/App/"→src/App/Services/UserService.php❌（多了一层App/） -
AppServicesUserService+ 目录实际是src/services/→ 自动加载器拼出src/services/UserService.php，但Linux下该路径不存在 - 检查方式：运行
composer dump-autoload -o后，打开vendor/composer/autoload_psr4.php确认映射关系是否符合预期
多个autoload配置段之间会覆盖，不是叠加
在 composer.json 中重复写 "psr-4" 键，后出现的会完全替换前面的，而不是合并。这是最隐蔽的类名冲突源头之一。
错误写法示例：
"autoload": {
"psr-4": { "App\": "src/" }
},
"autoload-dev": {
"psr-4": { "App\Tests\": "tests/" },
"psr-4": { "App\": "src/" } ← 这行会让上面的 "App\" 映射失效
}
- 同一JSON对象内不能有两个同名键，PHP解析时后者覆盖前者
- 正确做法：所有
App\相关映射必须收拢到同一个psr-4段里 - 开发专用命名空间（如测试类）应单独起前缀，例如
"AppTests\": "tests/"，避免和主命名空间交叉 - 改完立即运行
composer dump-autoload，别依赖缓存
第三方包引入后，其命名空间可能意外覆盖你的类
如果某依赖包也声明了 "App\": "vendor/some/package/src/"（极少见但可能），而你本地也有 App\ 命名空间，Composer会按 autoload 顺序加载——后注册的覆盖先注册的，导致你的类被跳过。
- 执行
composer show --installed查看所有已装包，再逐个检查它们的composer.json中 autoload 定义 - 优先使用唯一前缀，如
YourCompany\或项目缩写Acme\，而非泛泛的App\ - 若必须用
App\，可在composer.json顶部加注释提醒团队：“此命名空间为本项目专用，禁止第三方包复用” - CI流程中可加入脚本校验：提取全部
vendor/*/composer.json的 autoload 段，grep"App\\":报警
真正麻烦的从来不是找不到类，而是找到“错的类”——它编译通过、运行不报错，但逻辑悄悄走偏。命名规范这事，动手建第一个文件时就得钉死。
