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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 的路径映射与实际目录结构不一致。这两点不确认清楚，其他优化都建立在流沙之上。