PSR-4 完全支持嵌套命名空间，问题源于 composer.json 映射配置错误或目录结构不匹配；需确保命名空间末尾双反斜杠、路径大小写一致，并执行 composer dump-autoload 更新映射表。
PSR-4 本来就支持嵌套命名空间，不是“不支持”，而是映射规则写错了
Composer 的 PSR-4 完全支持 AppHttpControllersUserController 这类多层嵌套命名空间，问题几乎总是出在 composer.json 的配置写法或目录结构不匹配上。它不是靠“递归扫描”推导路径，而是用字符串替换：砍掉前缀 + 把 换成 / + 拼后缀。
常见错误现象：
-
Fatal error: Class 'AppHttpControllersUserController' not found，但文件明明在src/Http/Controllers/UserController.php - 顶层类（如
AppUser）能加载，子命名空间（如AppHttpUser）却报错
关键原因和实操建议：
-
"App": "src/"中的双反斜杠缺一不可——少一个就变成字面量"App"，导致所有子命名空间匹配失败 -
src/目录下不能有App/子目录；否则AppHttpControllers会被拼成src/App/Http/Controllers，而实际路径是src/Http/Controllers - 命名空间末尾必须带反斜杠，且 JSON 中必须写成双反斜杠：
"App\": "src/"（PHP 字符串中两个反斜杠才表示一个字面量反斜杠） - Linux/macOS 下路径大小写敏感：
src/Http/≠src/http/，IDE 自动补全有时会生成小写，要手动核对
为什么改了文件或 composer.json 后类还是找不到？
因为 Composer 不监听文件变化，vendor/autoload.php 只是注册加载器，真正干活的是 vendor/composer/autoload_psr4.php ——它是一个静态 PHP 数组，内容来自上一次 composer dump-autoload 的结果。
典型场景：
- 新增了
src/Services/CacheManager.php，但没运行composer dump-autoload→ 映射表里没有这条记录 - 把
"App\": "src/"改成"MyApp\": "src/"，但没重新 dump → 表里仍是旧前缀 - CI/CD 脚本用了
--no-scripts，跳过 autoload 生成 → 部署后必报错
必须执行的命令：
-
composer dump-autoload：基础重生成（推荐每次改完composer.json或增删类后都跑一遍） -
composer dump-autoload -a：强制重扫 classmap（如果你同时配了autoload.classmap） -
composer validate：检查composer.json格式是否合法，避免因语法错误导致 autoload 配置被忽略
classmap 是唯一真正“扫描目录”的方式，但它不解决命名空间问题
classmap 的作用不是“让嵌套命名空间自动生效”，而是绕过命名空间——它直接扫描你指定的目录，提取所有 class、interface、trait 声明，硬编码进 vendor/composer/autoload_classmap.php。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
适用场景：
- 老项目没命名空间，所有类都在
lib/下扁平存放 - 你想加载纯函数文件（需配合
autoload.files） - 你明确知道哪些路径需要被无条件扫描，且不依赖命名空间结构
配置示例：
{
"autoload": {
"psr-4": { "App\": "src/" },
"classmap": ["legacy/", "lib/"]
}
}
注意：
-
classmap不会自动包含新文件，仍需composer dump-autoload -a - 它和 PSR-4 共存时，优先级由 Composer 内部加载顺序决定，一般 PSR-4 先查，查不到再 fallback 到 classmap（但不建议依赖 fallback）
- 别把
tests/或examples/加进classmap，它们会被无差别扫描，徒增映射表体积
嵌套太深时容易忽略的细节：路径分隔符与跨目录映射
PSR-4 映射路径必须是相对于 composer.json 所在位置的相对路径，且不能以 / 开头（否则被当绝对路径静默跳过）。
比如想把上层目录 ../shared-utils/src/ 映射到 SharedUtils\：
- ✅ 正确：
"SharedUtils\": "../shared-utils/src/" - ❌ 错误：
"SharedUtils\": "/var/shared-utils/src/"（绝对路径，Composer 忽略） - ❌ 错误：
"SharedUtils\": "shared-utils/src/"（路径不存在，除非该目录真在当前项目下）
另一个易踩坑点：Windows 下开发时路径大小写不敏感，容易掩盖问题；上线前务必在 Linux 环境验证：
php -r "var_dump(class_exists('AppHttpControllersHomeController'));"
输出 bool(true) 才算真正通了——光 IDE 不报错、本地能跑，不代表部署没问题。
