第三方类库自动加载路径由其自身composer.json决定，需确保正确安装进vendor且autoload配置未被项目覆盖或忽略；require后Class not found主因是autoload映射未对齐，而非包缺失。
第三方类库自动加载路径不是“配出来”的，而是由它自己的 composer.json 决定的；你唯一要做的，是确保它被正确安装进 vendor/，且它的 autoload 配置没被你项目覆盖或忽略。
为什么 require 后 Class not found，但包明明在 vendor 里
常见错觉：以为只要 composer require vendor/package 成功，类就能直接 new。实际失败原因几乎全是 autoload 配置没对上。
- 第三方包自身
composer.json没写autoload字段（极少见，但存在） - 你项目根
composer.json里写了"autoload": { "psr-4": { ... } }，但没包含该包的命名空间前缀 —— Composer 不会自动合并子包的 autoload - 包用了
classmap或files，但你运行过composer dump-autoload -o却没加--no-dev或漏掉autoload-dev配置 - 包名带版本约束（如
"dev-main"），但本地 path 仓库没设对分支，或 Git HEAD 没 commit 导致 Composer 跳过扫描
如何确认第三方包的 autoload 是否生效
别猜，直接看生成的映射文件：
- 检查
vendor/composer/autoload_psr4.php：找对应包的命名空间键，比如"Monolog\Logger"→["monolog/monolog/src/"] - 检查
vendor/composer/autoload_classmap.php：搜类名，看是否已静态注册（适用于无命名空间的老包） - 运行
composer show vendor/package，看输出中Autoload行是否列出有效路径 - 用
composer dump-autoload -v观察 dump 过程中是否有 warning，例如 “Skipping classmap scan for …: directory not found”
第三方包 autoload 被你项目覆盖的典型场景
你的项目根 composer.json 里如果写了：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
那它只管 App 开头的类 —— 第三方包的 Monolog、GuzzleHttp 等完全不受影响，它们走的是各自包内定义的 autoload 规则。
但以下情况会出问题：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你手动改了
vendor/composer/autoload_*.php文件（禁止！每次dump-autoload都会被重写） - 你在根
composer.json的autoload里写了和第三方包冲突的前缀，比如也写了"Monolog\": "lib/monolog/"—— 这会覆盖包自带的映射，且路径大概率不存在 - 你用了
autoload-dev但测试时没加载 dev autoload（PHPUnit 默认只加载 production autoload）
path 类型本地第三方包必须显式声明 repositories
如果你把第三方包 clone 到本地（比如 packages/my-sdk），想当“第三方”用，composer require 不会自动识别它。
必须在项目根 composer.json 里补上：
{
"repositories": [
{
"type": "path",
"url": "./packages/my-sdk"
}
]
}
然后 composer require mycompany/sdk:dev-main（注意必须带 :dev-main，不能写 * 或 ^1.0）。
关键点：
-
url是相对于项目根composer.json的路径，不能以/开头 - 本地包目录下必须有合法
composer.json，含name和"version": "dev-main" - 本地包没
git init或没任何 commit，Composer 会静默跳过，不报错也不链接
最易被忽略的是：path 仓库配置完后，必须 composer update mycompany/sdk 才能触发软链，install 不会处理未声明的本地源。
