先检查vendor/composer/autoload_psr4.php或autoload_classmap.php是否含目标类映射，再确认composer.json中autoload配置格式正确、路径存在且命名空间与文件结构严格匹配，最后执行composer dump-autoload -v验证扫描结果。

composer dump-autoload 后类找不到？先确认 autoload 配置是否被读取

Composer 不会自动重载 composer.json 中的 autoload 配置，必须显式执行 dump-autoload。但即使命令成功返回，也不代表配置已生效——常见原因是配置格式错误、路径不存在或未匹配到实际文件结构。

最直接的验证方式是检查生成的自动加载文件：vendor/autoload.php 是否包含你期望的映射逻辑。如果用了 psr-4，可搜索生成的 vendor/composer/autoload_psr4.php；如果用了 classmap，则查 vendor/composer/autoload_classmap.php。

• psr-4 映射需满足：命名空间前缀 + 目录路径，且目录下必须有对应命名空间结构的子目录（如 "App\": "src/" 要求 src/App/SomeClass.php）
• classmap 会扫描指定路径下所有 PHP 文件并登记类名，但不会递归扫描符号链接，且不支持通配符
• 修改 composer.json 后必须运行 composer dump-autoload，加 -v 参数可看到扫描了哪些路径和文件

使用 composer show -p 查看当前生效的 autoload 规则

composer show -p 会输出项目中所有已注册的自动加载规则，包括 root 包和依赖包的配置。它比手动翻 composer.json 更可靠，因为会反映合并后的最终结果（例如插件或脚本可能动态修改 autoload）。

注意输出中 psr-4 和 classmap 的路径是否为绝对路径，以及是否指向你预期的目录。若显示路径是空字符串或 null，说明该规则未被识别（常见于拼写错误如 psr4 写成 psr4 或缩进不合法）。

Discussion Composer

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

下载

• 运行 composer show -p | grep -A5 "autoload" 快速定位 autoload 段落
• 若项目启用了 autoload-dev，它只在开发环境下生效，composer install --no-dev 后这些规则会被忽略
• 某些 IDE（如 PhpStorm）会缓存自动加载信息，改完配置后需重启索引或清空 cache

用 ComposerAutoloadClassLoader::getClassMap() 手动验证类是否注册

在代码中直接调用底层加载器，是最接近运行时真实行为的检测方式。只要 vendor/autoload.php 已引入，就能拿到当前 ClassLoader 实例并检查具体类是否被映射。

require_once 'vendor/autoload.php';
$loader = require 'vendor/autoload.php';
var_dump($loader->getClassMap()['MyAppSomeClass'] ?? 'not found');

如果返回 not found，说明该类没进入 classmap；如果是 psr-4 类，则需确认命名空间与文件路径是否严格匹配（包括大小写），Linux 系统下大小写敏感会导致“找到但不加载”。

• getClassMap() 只对 classmap 生效，psr-4 类需用 findFile() 方法测试：$loader->findFile('MyAppSomeClass')
• 确保测试脚本在项目根目录执行，否则相对路径解析可能出错
• 不要在 autoload-dev 下定义生产环境要用的类，否则 --no-dev 时不可用

require_once 强制加载成功但 new 报错？检查命名空间与文件物理位置一致性

能 require_once 成功，但 new SomeClass() 提示类未找到，通常不是 Composer 配置问题，而是命名空间声明与文件存放位置不一致。Composer 的 psr-4 是纯路径映射，不解析 PHP 文件内容。

例如配置 "App\": "src/"，而 src/Foo.php 里写的是 namespace Bar;，那 new AppFoo() 就永远找不到——因为 Composer 认为 AppFoo 应该在 src/Foo.php，但该文件实际声明的是 BarFoo。

• 用 php -l src/Foo.php 检查语法，再用 grep "^namespace" src/Foo.php 确认声明是否匹配预期
• Windows 下路径分隔符不影响 Composer，但 __DIR__ 在 require 中可能因大小写导致加载失败
• 如果类名含下划线（如 My_Class），PSR-0 已废弃，psr-4 不支持下划线转目录，必须用标准驼峰命名

自动加载是否生效，本质是“路径映射 + 命名空间 + 文件物理结构”三者是否咬合。最容易被忽略的是：你以为的路径是相对 composer.json 的，其实是相对于项目根目录的；你以为的命名空间是自由写的，其实它决定了 Composer 去哪找文件。