classmap 必须手动执行 composer dump-autoload 才生效，它仅在显式运行该命令时扫描指定路径下的 php 文件并生成静态映射，不监听文件变化、不解析命名空间、不支持热更新，路径须为项目根目录下带尾斜杠的相对路径。
classmap 必须手动执行 composer dump-autoload 才生效
写完 composer.json 里的 "classmap": ["src/", "lib/"]，类不会自动被识别。它不监听文件变化，也不在运行时扫描目录——只在你显式执行 composer dump-autoload 时，才去读取这些路径下的所有 .php 和 .inc 文件，提取其中的 class 声明，生成一个静态数组写入 vendor/composer/autoload_classmap.php。
常见错误现象：
-
use Utils\Helper;报Class not found，但src/Utils/Helper.php确实存在 - 改了类名或移动了文件，旧类还能加载，新类死活找不到
- 以为改完代码刷新页面就能生效，结果毫无反应
实操建议：
- 配置好
classmap后，立刻运行composer dump-autoload（不是install或update） - 开发中增删类文件后，必须重跑该命令；仅修改类内部逻辑无需重跑
- 检查
vendor/composer/autoload_classmap.php，搜索你的类名，确认键值对已写入
classmap 路径必须是项目根目录下的相对路径
composer.json 中 classmap 数组里的路径，是相对于该文件所在位置（即项目根目录）的路径，不是相对于 vendor/autoload.php，也不能是绝对路径或带 ./ 的形式。
常见错误写法：
-
"./src/"—— 多余的点斜杠，某些旧版 Composer 解析异常 -
"/var/www/myapp/src/"—— 绝对路径，完全无效 -
"src"—— 缺少末尾斜杠，可能导致路径拼接错误（如srcUtils/Helper.php）
正确写法统一用 "src/"、"lib/" 这类结尾带斜杠的相对路径。子目录（如 src/Utils/Helper.php）会被自动递归扫描，无需额外配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
classmap 不解析命名空间，只认类名全称
classmap 加载机制完全忽略命名空间声明。它只看 PHP 文件里实际定义了哪些类，然后把完整类名（含反斜杠）作为数组键，映射到该文件的绝对路径。这意味着你可以混用无命名空间类（class Helper）和带命名空间类（class App\Utils\Helper），它们都会被收录。
适用场景：
- 老项目里一堆
functions.php或无命名空间的Config.php、DB.php - 第三方 SDK 类名混乱、路径随意（如
class WeChatAPI直接定义在sdk/wechat.php） - 多个同名类存在于不同目录（
App\User和Legacy\User），PSR-4 会冲突，classmap能区分
注意：classmap 不做路径推导，也不校验命名空间与文件路径是否匹配。它只负责“这个类名 → 这个文件”，所以灵活性低，但确定性高。
--classmap-authoritative 模式下，没进 classmap 就等于不存在
加上 --classmap-authoritative 参数后，Composer 加载器会彻底关闭 PSR-4/PSR-0 fallback，只信任 autoload_classmap.php 里的映射。任何未出现在该文件中的类，哪怕路径和命名空间完全符合 PSR-4 规则，也会直接报 Class not found。
这个模式只适合类结构冻结的部署场景，比如 SaaS 打包发布、CI/CD 构建固定镜像。它要求：
- 必须配合
--optimize-autoloader使用，否则权威模式下缺失映射等于功能不可用 - 所有类都得进
classmap，包括files加载的纯函数文件不会被包含，需确保它们不依赖类加载 -
autoload_dev中的测试类不能混进主classmap，否则体积暴涨且污染生产映射
真正容易被忽略的是：classmap 的静态性——它不感知文件变更，也不支持热更新。一旦启用权威模式，漏掉一个类，就是线上故障。
