Class not found主因是autoload未生效：需运行composer dump-autoload -o重建映射，检查vendor/composer/autoload_psr4.php中命名空间与路径是否匹配，确认类名、命名空间、文件路径及大小写严格符合PSR-4规范。
直接用 composer require 就能装，但装完类找不到，八成不是命令没跑对，而是 autoload 没刷、路径写错、或 PHP 版本卡住了。
composer require 装完类还是 not found？先查 autoload 是否生效
装包只是把文件扔进 vendor/，类能不能被 new 出来，全靠 autoload 规则是否被加载进 vendor/autoload.php。很多“装了却用不了”的问题，根源在这里。
- 运行
composer require monolog/monolog后，立刻检查vendor/composer/autoload_psr4.php里有没有Monolog\开头的映射 —— 没有就说明包自身的 autoload 没被合并进来 - 如果你手动改过根目录
composer.json的"autoload"字段（比如加了"apputils": "app/utils/"），必须再跑一次composer dump-autoload -o，否则新规则完全不生效 -
files类型加载的函数文件（如"files": ["app/helpers.php"]）会在每次请求时无条件 include，但只适合纯函数/常量，千万别塞含class定义的文件，否则直接报Fatal error: Cannot declare class
非 Composer 包怎么引？classmap 是唯一靠谱方案
遇到只有 .zip、没 composer.json、类名和文件名不一致、甚至定义在 .inc 文件里的老库，psr-4 和 files 都不管用，只能靠 classmap。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的"autoload"下加："classmap": ["extend/legacy-sdk/", "lib/Database.inc"]—— 路径必须真实存在，末尾带/表示递归扫描 - 写完立刻执行
composer dump-autoload，然后打开vendor/composer/autoload_classmap.php，搜索你的类名，确认键值对已生成 - 注意 PSR-4 优先级永远高于 classmap：如果
legacy-sdk/MyDB.php被"App\": "app/"这类映射“误覆盖”，哪怕它没命名空间，也会跳过 classmap 扫描 - Linux 下大小写敏感：
MyDB.php里定义class mydb→ 加载失败；文件语法错误（比如少个分号）→ classmap 扫描时静默跳过，不报错也不写入映射
require 命令常见翻车点
看似一条命令的事，实际踩坑集中在版本约束、执行位置和环境一致性上。
- 别在空目录或
public/子目录下执行composer require—— 报Could not find a composer.json file就是当前目录不对 - 包名拼错很常见：
illuminate/cache对，illuminate-cache（短横线）错；guzzlehttp/guzzle对，guzzle/guzzle错 - PHP 版本不匹配时，报错里会明确写
requires php ^8.1，而你本地是 8.0 —— 临时调试可用--ignore-platform-reqs，但上线前必须升级 PHP 或换兼容版本 - CI/CD 部署时用
composer install，不是require或update；且必须确保composer.lock已提交，否则线上依赖和本地不一致
ThinkPHP 6 项目要特别注意的 autoload 细节
TP6 不是“支持 Composer”，而是“完全依赖 Composer 自动加载”，入口文件那一行 require __DIR__ . '/../vendor/autoload.php' 缺一不可。
- 自定义类（如
app/utils/ArrHelper.php）必须在composer.json里显式注册 PSR-4 映射，且类名与文件名严格一致（ArrHelper.php→class ArrHelper），大小写不能错 - 第三方 SDK（如百度 AIP）若无 composer.json，别塞
vendor/，放进extend/目录后用require_once EXTEND_PATH . 'aipbaidusdk/AipNlp.php'手动加载，实例化时加反斜杠：new AipNlp() - 修改
composer.json后忘了composer dump-autoload -o，开发中常因 autoload 缓存未更新导致“刚写的类死活找不到”
autoload 规则不是写完就生效，也不是装完包就自动注入 —— 它是一张静态映射表，靠 dump-autoload 生成，靠 vendor/autoload.php 引入，靠 PHP 运行时按图索骥。任何一环断掉，Class not found 就必然出现。
