composer install 找不到非 composer 包的类，因其仅自动加载 autoload 配置声明的路径；需用 classmap 手动映射 vendor/legacy/sdk-v2.1/ 等目录，并执行 composer dump-autoload 生成映射表。
为什么 composer install 找不到非 Composer 包的类？
因为 Composer 默认只扫描 autoload 配置里声明的命名空间或路径，对直接扔进 vendor/ 里、没 composer.json 的第三方包（比如某些老 PHP 库、定制 SDK、或从 SVN/Git Submodule 拉下来的纯 PHP 文件集），它根本不会自动注册 autoloader。不是“没装好”，是压根没被纳入加载逻辑。
用 classmap 是最稳的手动映射方式
classmap 不依赖文件命名或目录结构，只靠实际扫描到的 .php 文件里的 class、interface、trait 声明来生成映射表，适合无命名空间、混用下划线命名、甚至全局函数的老旧包。
操作步骤：
- 把第三方包完整放到项目内一个固定位置，例如
vendor/legacy/sdk-v2.1/ - 在项目根目录的
composer.json的autoload段加："autoload": { "classmap": ["vendor/legacy/sdk-v2.1/"] } - 运行
composer dump-autoload（不是install或update）——这步才真正生成映射
注意：如果包里有同名类（比如多个 Utils.php 都定义了 class Utils），classmap 会报错并中断生成，得先人工去重。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
遇到 Class not found 但 classmap 已生效？查这三个点
常见于混合环境或缓存残留：
-
vendor/autoload.php是否被正确引入？有些脚本绕过它直连index.php，导致 classmap 失效 - 是否误用了
psr-4规则去“猜”这个包的命名空间？classmap不走命名空间解析，类名必须字面匹配文件里写的class Xxx - 运行过
composer dump-autoload -o（优化模式）后改了文件但没重新 dump？优化后的autoload_classmap.php不会热更新，必须再执行一次dump-autoload
比 files 和 include 更可靠，但别滥用
files 方式（直接 require 一堆 .php）能加载函数，但无法解决类重复定义问题；手写 include 更是破坏自动加载契约。而 classmap 由 Composer 统一管理加载时机，支持 APCu 缓存，也兼容 PHP 7.4+ 的 opcache preload。
不过它有个硬限制：每次增删类文件都得重新 dump-autoload，不适合开发中高频改动的目录。上线前固化、CI 流程里加入 dump 步骤，才是合理用法。
真正麻烦的从来不是怎么映射，而是包里那些没文档的静态方法调用顺序、隐式依赖的 ini 设置、或者写死的绝对路径 —— 这些得一行行翻源码。
