纯静态类库必须用classmap，因psr-4和-o不扫描无命名空间文件；需在composer.json中声明"classmap"并执行dump-autoload -a，再配合--no-dev与--optimize-autoloader上线。
纯静态类库（无命名空间、无 PSR-4 结构）必须用 classmap，不能靠 psr-4 或 -o 自动“猜”——否则类根本不会被收录进自动加载器。
为什么 composer dump-autoload -o 对静态类库无效
Composer 的 -o（即 --optimize-autoloader）只优化已声明的 PSR-0/PSR-4 映射，它不会主动扫描目录生成 classmap，除非你已经在 composer.json 里显式配置了 "classmap" 字段。
纯静态类库（如 MyHelper.php、functions.php、Database.php）通常：
- 没有
namespace声明 - 文件名与类名不遵循 PSR-4 路径规则（比如
src/Utils/MyHelper.php里定义class MyHelper，但没 namespace） - 依赖
require_once式加载，或靠全局函数调用
这类文件在默认 PSR-4 模式下完全不可见，-o 执行后 autoload_classmap.php 里依然为空。
必须手动声明 classmap 并用 -a 强制重扫
正确做法是把静态类所在目录写死进 autoload.classmap，再运行 composer dump-autoload -a（-a = --classmap-authoritative 的扫描动作，不是开关）：
{
"autoload": {
"classmap": ["src/legacy/", "lib/utils/", "app/helpers/"]
}
}
然后执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer dump-autoload -a—— 递归扫描每个.php文件，提取class、interface、trait声明，写入autoload_classmap.php - 不要只用
-o：它对未声明的路径不扫描，哪怕目录里全是合法类文件 - 避免混入
tests/或docs/：它们会被无差别扫描，膨胀 classmap 文件体积
验证 classmap 是否真生效
别只看命令是否跑过，要确认类名是否真的进了映射表：
- 运行
php -r "var_dump(require 'vendor/composer/autoload_classmap.php');"，搜索你的类名（如'MyHelper'），确认有对应路径 - 运行
php -r "var_dump(class_exists('MyHelper'));"，返回true才算成功 - 如果返回
false，常见原因：MyHelper.php里用了namespace却没匹配 PSR-4；或文件里只有函数没class声明（classmap不收录函数）
注意：classmap 不处理 "files" 类型加载项（如全局函数文件），那是另一套机制，需单独配置。
生产部署时的两个关键开关
仅生成 classmap 还不够，上线前必须加这两个参数一起用：
-
--no-dev：排除autoload-dev里的路径，防止测试类污染主 classmap -
--optimize-autoloader（或-o）：让vendor/autoload.php实际走 classmap 查表路径，而不是 fallback 到 PSR-4
标准命令是：
composer install --no-dev --optimize-autoloader
漏掉 --no-dev，dev 包里的类可能挤占 classmap 空间；漏掉 --optimize-autoloader，即使 autoload_classmap.php 存在，运行时也不会优先查它。
最易忽略的一点：classmap 是快照，不是实时监听。新增一个 OldDb.php 后，必须重新 dump-autoload -a，否则它永远不在自动加载范围内。
