classmap 是解决无命名空间类等问题的必要配置，必须用相对路径（如"legacy/"或"src/helpers.php"），且需执行 composer dump-autoload 才生效；优先级低于 psr-4，冲突时后者覆盖前者。
classmap 配置不是“可选优化项”，而是解决无命名空间类、扁平目录或遗留代码加载问题的必要手段；不写 composer dump-autoload，改了 composer.json 也完全无效。
classmap 路径怎么写才被扫描到
classmap 只认相对路径，且不能以 / 开头。它支持目录（递归扫描所有 .php 和 .inc）和具体文件（只扫那个文件），但不支持通配符。
- 目录写法：写
"legacy/"✅，会扫描legacy/Database.php、legacy/Utils.class.php等全部 PHP 文件 - 文件写法：写
"src/Helpers.php"✅，只扫描这一个文件；写"Helpers.php"❌，会被当作当前目录下文件，极易错位 - 错误示例：
"/legacy/"、"./legacy/"、"legacy/*.php"—— 全部被忽略，无报错，静默失效
Windows 下用反斜杠 \ 拼路径（如 "legacy\Utils.php"）可能被解析为空字符串，统一用正斜杠 /。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么 classmap 生效了却 still Class not found
最常见原因不是配置错，而是没验证生成结果。Composer 不报错不等于映射成功。- 运行
composer dump-autoload后，立刻打开vendor/composer/autoload_classmap.php，搜索你的类名（比如LegacyDatabase），看是否真有对应路径条目 - 如果没有，检查该类文件是否被
.gitignore排除（Composer 默认跳过被忽略的文件） - 运行
composer dump-autoload -o强制重建，它会输出警告（如 “syntax error in legacy/Utils.php”），能暴露隐藏问题 - 类名大小写必须完全一致：
LegacyDatabase≠legacyDatabase，哪怕文件系统不区分，Composer 映射表也严格区分
classmap 和 psr-4 同时存在时谁优先
classmap 优先级低于 psr-4。如果两个规则都命中同一个类名，PSR-4 的路径会先被加载，classmap 条目被忽略。
- 例如：你同时配置了
"psr-4": {"App\": "src/"}和"classmap": ["legacy/"]，而AppDatabase在legacy/Database.php里定义 —— Composer 会去src/Database.php找，找不到就报错，根本不会查classmap - 解决办法只有两个：要么把类移到 PSR-4 规则覆盖的路径下，要么确保类名不与任何 PSR-4 命名空间冲突（比如改名成
LegacyDatabase） - 没有开关能“提升 classmap 优先级”，这是 Composer 内置加载顺序，不可更改
files 加载函数时为什么 Call to undefined function
files 是无条件 require_once，但它只在 vendor/autoload.php 被引入后才触发。
- 入口文件（如
index.php）必须第一行就写require <strong>DIR</strong> . '/vendor/autoload.php';，漏掉或写在其他require之后，函数永远不可见 -
files数组里的路径是相对于composer.json的，不是入口文件，也不是vendor/—— 写成"helpers.php"就是在项目根目录找，写成"src/helpers.php"才对 - 如果多个
files定义了同名函数，按数组顺序加载，但 Composer 不保证顺序绝对可靠；更稳妥的是把有依赖的函数合并进单个文件，避免跨文件调用
真正容易被忽略的一点：classmap 扫描的是“文件里声明的所有类”，不管有没有命名空间、是不是 class 关键字开头（比如 interface、trait 也会被收录），但如果你的旧代码用 function_exists() 动态判断类是否存在，那它绕过了自动加载机制——这种逻辑要重写。
