根本原因是改完composer.json后未执行composer dump-autoload，导致vendor/composer/autoload_psr4.php未更新；PSR-4命名空间须双反斜杠结尾、路径须正斜杠结尾且为相对路径，配置必须在顶层autoload字段中。

composer.json改了autoload但类还是找不到

根本不是 Composer 没读你的配置，而是它压根没把新规则写进 vendor/composer/autoload_psr4.php——改完 composer.json 后不手动执行命令，文件永远是旧的。

• autoload 必须是顶层字段，不能嵌在 require 或 scripts 里；拼错成 autoloader 或带下划线也会被完全忽略
• PSR-4 命名空间必须以双反斜杠结尾："App\" ✅，"App" ❌，"App"（JSON 中只表示一个反斜杠）也 ❌
• 路径必须是相对路径、正斜杠结尾："src/" ✅，"src" ❌（拼接时会变成 srcMyClass.php），"./src/" 或 "/src/" 都不认
• 改完立刻跑 composer dump-autoload（简写 composer du），别等 install 或 update ——它们只在 composer.lock 变更时才顺带触发 autoload 重生成

运行 dump-autoload -v 却没看到我的命名空间

说明配置没被识别，不是路径或大小写问题，而是更底层的解析失败。这时候别猜，让 Composer 自己报错。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 先运行 composer validate，检查 JSON 格式：漏逗号、多逗号、中文引号、BOM 头都会导致 autoload 被跳过
• 用 composer dump-autoload -v 看输出末尾：如果连 Scanning packages... 都没出现，大概率是 composer.json 语法错误
• 如果输出里有扫描日志但没你的前缀（比如搜不到 App\），再确认命名空间字符串是否被其他配置项意外截断——比如前面加了空格、tab，或后面多了不可见字符
• Linux/macOS 下用 cat -A composer.json | grep App 查看是否有隐藏符号

本地能加载，上线就 Class not found

线上环境不会原谅开发时的松懈：大小写、权限、引入路径，三者错一个就全挂。

• 入口文件必须用 require __DIR__ . '/vendor/autoload.php';，不能用 require 'vendor/autoload.php' —— 当前工作目录（getcwd()）在 CLI 和 Web SAPI 下可能完全不同
• Linux 服务器严格区分大小写：类名 UserService 对应的文件必须叫 UserService.php，目录必须是 src/Service/，不能是 src/service/
• 检查 vendor/autoload.php 文件权限：ls -l vendor/autoload.php 应显示至少 -rw-r--r--；Web 用户（如 www-data）必须有读权限
• 上线不要复制 vendor/，而要在服务器上跑 composer install --no-dev --optimize-autoloader，确保 autoload 映射与目标环境匹配

第三方包的类明明在 vendor 里却找不到

不是所有包都默认可自动加载。Composer 只按它自己注册的规则找类，不会扫描 vendor 目录下的任意 PHP 文件。

• 先查包有没有声明 autoload：composer show vendor/package | grep autoload，输出为空或 {} 表示该包没配自动加载
• 有些包只提供 files 类型 autoload（比如纯函数库），这类文件必须靠 composer dump-autoload 生成 autoload_files.php 才生效
• Laravel 扩展包常需手动注册服务提供者，不能只靠 PSR-4；查文档确认是否要往 config/app.php 的 providers 数组里加条目
• 若包用了自定义命名空间（如 Acme\Utils\），而你项目没在 autoload 里声明映射，就得在主项目的 composer.json 中补上对应 PSR-4 规则并重新 dump-autoload

复杂点在于：autoload 映射一旦生成，就不会动态更新；而 PHP 的 opcache、APCu 或某些 SAPI 的预加载机制，还可能缓存旧的映射逻辑。调试时最容易被忽略的是——你以为改了配置，其实 Composer 根本没读到，或者读到了但没写进去。