composer dump-autoload -o 必须手动触发，因为 vendor/composer/autoload_classmap.php 是静态数组，不随代码变更自动更新；修改 composer.json 中的 autoload 配置后，必须执行该命令才能刷新类映射，否则 php 加载器仍使用旧映射导致类找不到。
composer dump-autoload -o 为什么必须手动触发？
因为 vendor/composer/autoload_classmap.php 是静态 PHP 数组，不是运行时动态生成的。改了 composer.json 里的 "classmap" 或 "psr-4"，不跑 composer dump-autoload -o，这个文件就永远不变——PHP 加载器查的还是旧映射，类自然找不到。
常见错误现象：Class 'AppServicesLogger' not found，但文件明明在 src/Services/Logger.php，且 "App\": "src/" 配得也对。问题往往出在：你加了新类，却忘了执行命令。
-
composer install和composer update会自动触发一次dump-autoload，但仅限于依赖包变化时；你自己项目代码变动，它不管 - CI/CD 中若跳过这步（比如用缓存 vendor 目录但没重跑 autoload），部署后必炸
- Windows 下路径写成
"srcservices"（反斜杠）可能被 Composer 解析失败，统一用/
autoload_classmap.php 的合并逻辑到底怎么工作？
它不是“把所有类名拼一起”，而是按 composer.json 中 autoload 和 autoload-dev 两块分别扫描，再合并进同一个数组。关键点在于：哪些路径会被扫、哪些不会、哪些内容会被收录。
示例配置：
{
"autoload": {
"psr-4": { "App\": "src/" },
"classmap": ["legacy/", "helpers.php"]
},
"autoload-dev": {
"psr-4": { "AppTest\": "tests/" }
}
}
-
src/下所有.php文件，只要含class、interface或trait声明，都会被提取并映射，如AppControllerHome→src/Controller/Home.php -
legacy/目录递归扫描，同样只收类结构体；helpers.php里只有函数？那它不会进autoload_classmap.php，但会写入autoload_files.php -
tests/默认不扫——除非你加--dev参数，否则AppTestSomething就不在 classmap 里 - 如果
legacy/为空或根本不存在，Composer 静默跳过，不报错也不留空条目
PSR-4 映射和 classmap 映射在 autoload_classmap.php 里怎么共存？
它们不共存于同一张表。autoload_classmap.php 只存“类名 → 文件路径”的精确一对一映射；而 PSR-4 的前缀规则仍保留在 autoload_psr4.php 中。-o 模式下，Composer 做的是“双轨加载”：先查 classmap，命中就直接 require；没命中才 fallback 到 PSR-4 规则解析。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
这意味着：
- 一个类如果同时满足 PSR-4 规则和出现在 classmap 中，classmap 优先——这是性能优化的核心
- 如果你在
"classmap": ["src/"]里重复声明了已由 PSR-4 覆盖的目录，Composer 会把 src/ 下所有类都扫一遍，写进 classmap，相当于“强制预热”，但没必要 -
--classmap-authoritative会让 Composer 完全忽略 PSR-4 fallback，查不到就直接报错——这要求 classmap 必须 100% 完整，否则上线即崩
为什么有时候 classmap 里找不到刚写的类？
最常踩的坑是：类文件里命名空间或类名和实际路径不匹配，或者用了非法字符。Composer 扫描时只认标准语法结构，不执行代码。
典型问题：
- 文件名是
UserController.php，但里面写class usercontroller（小写）→ 不收录，Linux 下大小写敏感 - 类定义前有 BOM 头或 UTF-8 签名 → Composer 解析失败，跳过该文件
- 用了 PHP 8.4+ 的新语法（如
enum、readonly class），但当前 Composer 版本太老（ - 路径配成
"App\": "src"（缺末尾/）→ PSR-4 映射失效，但 classmap 扫描仍能收录类，只是加载时路径拼错，file_exists()返回 false
调试建议：直接打开 vendor/composer/autoload_classmap.php 搜类名，看有没有；没有，就说明扫描环节漏掉了——别急着改加载逻辑，先确认文件、命名、路径三者是否闭环。
