新增依赖后类找不到等问题，90%是autoload映射未更新或PSR-4配置错误；需检查vendor/autoload.php修改时间、确认composer show结果，执行composer dump-autoload -o修复，并验证PSR-4前缀反斜杠、路径准确性及大小写一致性。
新增依赖后类找不到、重复定义或 Class not found 报错，90% 不是包没装上，而是 autoload 映射没更新或映射规则本身写错了。
composer require 后 autoload 没刷新？先确认是否真执行了
默认情况下 composer require 会触发 dump-autoload，但以下情况会静默跳过：
- 你之前用过
--no-scripts或--no-autoloader参数 - 手动改过
vendor/autoload.php或删过其中某段逻辑 -
composer.json里禁用了scripts（如"scripts": {}）
验证方法：检查 vendor/autoload.php 文件修改时间，必须比 composer require 命令执行时间新；再运行 composer show 包名 确认已安装。
补救操作：直接执行 composer dump-autoload -o（加 -o 强制优化 classmap，尤其适合新增了文件但没改命名空间的场景）。
PSR-4 映射不生效？三要素缺一不可
Composer 的 PSR-4 加载器不做容错，只按配置字面拼路径。常见失效点：
- 命名空间前缀末尾漏反斜杠：
"App": "app/"❌ → 必须写成"App\": "app/"✅ - 路径不是相对
composer.json的真实路径：比如"src/"对应文件在./src/Helpers/Util.php，但命名空间却是namespace Helpers;，那它永远匹配不到 - 大小写不一致：Linux 下
UserService.php和userservice.php是两个文件，Windows 可能“凑合过”，部署到生产就崩
快速验证：打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如 'App\'），确认对应路径数组里有没有 $baseDir . '/app' 这样的条目。
多个 autoload 规则混用导致“两头不靠”
比如你在 composer.json 中同时写了：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"autoload": {
"psr-4": { "MyLib\": "lib/" },
"classmap": [ "lib/Utils.php" ]
}
这时如果 lib/Utils.php 里没声明 namespace MyLib;，PSR-4 规则不认它，classmap 又被 PSR-4 覆盖优先级，结果就是文件加载失败。
解决原则：
- PSR-4 用于有命名空间的新代码，靠 namespace + 目录结构定位
- classmap 用于无命名空间的老代码或纯函数文件，靠路径直连
- 同一类名不能同时出现在两种规则中，否则行为未定义
临时排查：删掉 vendor/composer/autoload_*.php 全部文件，再跑一次 composer dump-autoload -o，跳过缓存直写。
ThinkPHP / Laravel 等框架项目要额外防“复用 vendor”
多个项目共用一个 vendor 目录（比如设了 COMPOSER_VENDOR_DIR 环境变量），会导致 vendor/autoload.php 里硬编码的 __DIR__ 指向错误路径，PSR-4 映射全乱。
检查方式：进项目根目录执行 php -r "echo __DIR__;"，和 vendor/autoload.php 开头的 __DIR__ 对比是否一致。
修复动作：
- 删掉系统级
COMPOSER_VENDOR_DIR环境变量 - 每个项目独立执行
composer install --no-dev --optimize-autoloader - 完成后立刻跑
composer dump-autoload -o
最隐蔽的坑是：你以为 composer dump-autoload 生效了，其实只是本地 PHP 缓存了旧 opcode——上线后记得清 OPCache 或重启 PHP-FPM。
