Composer 不会自动加载类，必须在 composer.json 中正确配置 PSR-4 映射（如 "App\": "src/"），严格匹配命名空间与目录结构，并执行 composer dump-autoload；测试类须用 autoload-dev 单独管理，classmap 适用于旧代码或性能敏感场景。
Composer 不会自动加载你写的类，除非你在 composer.json 里明确告诉它“从哪找、怎么拼路径”，并且执行 composer dump-autoload ——漏掉任一环节，Class not found 就必然发生。
PSR-4 映射必须严格匹配命名空间与目录结构
PSR-4 不是智能推导，而是字符串替换：砍掉命名空间前缀，把剩余部分里的 换成 /，再拼上配置的目录路径。比如配置 "App\": "src/"，那么 AppHttpControllerHomeController 就必须对应 src/Http/Controller/HomeController.php。
-
"App\": "src/App/"是典型错误——这会让 Composer 去找src/App/Http/Controller/HomeController.php，而实际文件在src/Http/Controller/下 -
"App": "src/"中的双反斜杠\是必须的，PHP 字符串中单个会被转义，漏掉就变成无效映射，且静默失败 - 路径大小写敏感：
src/Http/和src/http/在 Linux/macOS 下是两个目录，Windows 下也可能因 IDE 或 Git 设置导致不一致 - 末尾斜杠可加可不加，但建议统一用
"src"（无尾部斜杠），避免部分 Composer 版本警告
改完 composer.json 后必须手动运行 composer dump-autoload
Composer 的自动加载不是实时监听或热更新机制，它只在安装、更新或显式调用时生成 vendor/autoload.php 和内部映射表。改了命名空间、移动了文件、更新了 autoload 配置，不执行这一步，代码永远找不到类。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 开发中常用：
composer dump-autoload（验证映射） - 生产环境推荐：
composer dump-autoload -o（生成 classmap，跳过路径拼接和file_exists()调用） - 如果新增了文件但没被扫描到（比如加了
src/Utils/Helper.php却没在 PSR-4 下声明AppUtils），-o也不会包含它——此时应补全 PSR-4 映射，或改用classmap - CI/CD 流程中务必固定加入该命令，不能依赖
composer install自动触发
测试类必须用 autoload-dev 单独管理
把 tests/ 目录塞进主 autoload.psrr-4 是常见隐患：生产环境部署时若未加 --no-dev，测试类可能被意外加载，甚至触发初始化逻辑（如数据库连接、Mock 创建），造成线上异常。
- 正确做法是单独配置：
"autoload-dev": { "psr-4": { "Tests\": "tests/" } } -
composer install --no-dev时，Tests根本不会写入vendor/autoload.php - PHPUnit 默认读取
autoload-dev，所以测试报Class not found时，先检查这里是否配错路径或漏了\ - 不要为了图省事把
tests/加进主 autoload —— 安全边界一旦模糊，排查成本远高于多写一行配置
classmap 适合旧代码或性能敏感场景
PSR-4 依赖运行时路径拼接和文件存在判断，而 classmap 是提前扫描所有 PHP 文件、提取 class/interface/trait 声明后生成的静态数组，查找是 O(1) 纯内存操作。
- 适用场景：无命名空间的旧类、工具函数文件（用
files）、或想彻底规避 I/O 开销的高并发服务 - 配置示例：
"autoload": { "classmap": ["src/", "lib/", "app/Exceptions/"] } - 增删类文件后必须重新运行
composer dump-autoload -a（-a强制重扫，比-o更彻底） -
vendor/composer/autoload_classmap.php是最终产物，部署前可直接检查里面是否有你预期的类名和路径
最常被跳过的动作是改完 composer.json 后忘记 dump-autoload；最常被写错的是 PSR-4 的路径映射与实际目录结构不一致。这两点不确认清楚，其他优化都建立在流沙之上。
