class not found 错误主因是 composer.json 的 autoload 配置、类文件路径、php 中 namespace 声明三者未严格对齐：命名空间末尾须双反斜杠、路径大小写敏感、文件名与类名完全一致，且修改后必须执行 composer dump-autoload -o 重建映射。
Class not found 不是 Composer 坏了，而是 composer.json、文件路径、namespace 三者没对齐——差一个斜杠、少一级目录、大小写错一个字母，就加载失败。
composer.json 的 autoload 字段必须写对位置和格式
PSR-4 映射不是“随便加一行就行”，它必须是 composer.json 的顶层字段，和 name、require 并列。常见静默失效是因为写在了 scripts 或 config 里，Composer 直接忽略。
-
"autoload"键名不能拼错（比如"autoloader"或"auto-load"） - 命名空间键必须以双反斜杠结尾：
"App\": "src/"✅，"App": "src/"❌（JSON 解析后变成无尾缀命名空间，匹配失败） - 路径值是相对于
composer.json所在目录的子路径，不支持../src或绝对路径（如/var/www/src） - 路径末尾建议加
/："src/"比"src"更安全，避免和同名文件冲突
类文件路径必须和 namespace 层级完全一致
Composer 不扫描文件，只做字符串拼接：剥离配置中声明的命名空间前缀后，剩余部分转成路径，再拼上根目录。例如 "App": "src/" + AppHttpControllersHomeController → 拼出 src/Http/Controllers/HomeController.php。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/HomeController.php，不能少Http或Controllers任一层 - Linux/macOS 下
src/http/controllers/≠src/Http/Controllers/，大小写不一致直接报错；Windows 开发也请严格保持，否则上线即崩 - 类名必须和文件名完全一致：
class ApiResponse→ 文件必须叫ApiResponse.php，不是apiresponse.php或ApiResponseController.php - PHP 文件内
namespace声明不能有空格或 tab 缩进：namespace AppHttpControllers;✅，namespace AppHttpControllers ;❌
改完配置后必须手动运行 composer dump-autoload
vendor/autoload.php 只是入口，真正起作用的是 vendor/composer/autoload_psr4.php —— 这个文件不会自动更新，必须靠 composer dump-autoload 重写。
- 开发中建议加
-o参数：composer dump-autoload -o，生成静态 classmap，跳过运行时路径拼接和文件存在性检查，加载更快 -
composer install或update默认会触发dump-autoload，但仅限于依赖变更；你自己加的映射，必须手动跑 - CI/CD 部署时建议固定用
composer install --no-dev+composer dump-autoload -o，避免本地未提交的 autoload 配置污染线上 - 用
composer show -p可查看当前已注册的 PSR-4 映射，验证是否生效
别把 Tests 命名空间配进主 autoload
把 Tests 配在主 autoload 里看似省事，实则埋雷：测试类会被加载进生产环境，可能引发意外副作用或性能损耗。
- 正确做法是用
autoload-dev单独配置："autoload-dev": {"psr-4": {"Tests\": "tests/"}} - 这样
composer install --no-dev就不会加载测试代码 - 多个命名空间指向同一目录？别硬凑。一个目录不能同时属于两个不同根命名空间（比如
App和Domain），强行共用会导致类名冲突或自动加载失败
最常被忽略的一点：PSR-4 不是“写完配置就完事”，它要求你持续校验三者一致性——composer.json 里的映射、PHP 文件里的 namespace 声明、磁盘上的真实路径与文件名。任何一环脱节，Class not found 就立刻出现，且毫无商量余地。
