composer自动加载需在composer.json中显式配置autoload字段：psr-4适用于有命名空间的规整目录（如"app\": "src/"），classmap适用于无命名空间或结构混乱的老代码（如"lib/"），禁止混用psr-0，注意路径不重叠、命名空间与文件路径严格一致，修改后须执行composer dump-autoload。

composer.json 里怎么配 autoload 才能跨目录加载

Composer 自动加载不是靠“扫描目录”实现的，而是依赖 composer.json 中 autoload 字段的显式声明。如果你把类分散在 src/、lib/、app/Models/ 等多个路径下，必须一一列出来，否则 composer dump-autoload 根本不会生成对应映射。

常见错误是只写了一个 "psr-4": {"App\": "src/"}，结果 lib/Helper.php 里的 Helper 类死活找不到——因为没告诉 Composer 这个路径也归你管。

• psr-4 最适合有命名空间且结构规整的目录（如 src/Http/Controllers/ → AppHttpControllers）
• classmap 适合无命名空间、或命名空间混乱的老代码（比如 lib/ 下一堆 function + class 混写）
• 别混用 psr-4 和 psr-0，后者已废弃，PHP 7.4+ 兼容性差

psr-4 映射多个命名空间时要注意路径重叠

如果同时配置了 "App\": "src/" 和 "App\Http\": "app/Http/"，Composer 会优先匹配更长的命名空间前缀，但实际加载时可能出问题：当 AppHttpController 类本该从 app/Http/Controller.php 加载，却因 src/Http/Controller.php 存在而被错误命中——因为 src/ 被映射到了 App\，而 AppHttp 是它的子集。

解决方法很简单：确保路径不交叉，或者用 classmap 单独处理冲突目录。

• 推荐做法：所有 PSR-4 映射的目录物理上互不嵌套，例如 "App\": "src/"、"Legacy\": "lib/"
• 如果必须共用前缀（如都用 App\），就只留一个最宽泛的映射，其余用 files 或 classmap 补充
• 运行 composer dump-autoload -v 可看到每条映射实际解析到哪些文件，方便验证

classmap 怎么加非标准结构的类文件

classmap 不看命名空间，只扫描指定路径下的所有 .php 文件并建立“类名 → 文件路径”的静态映射表。它适合加载 lib/Database.php（类叫 Database，没命名空间）、vendor/oldpkg/Utils.php（函数+类混写）这类场景。

Discussion Composer

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

下载

注意：classmap 是一次性扫描，改了文件名或新增类后必须重新运行 composer dump-autoload，否则新类不会进自动加载列表。

• 在 composer.json 的 autoload.classmap 数组里直接写路径："lib/"、"vendor/oldpkg/"，甚至具体文件："lib/Helpers/Str.php"
• 避免写太宽泛的路径如 "./"，会拖慢 dump-autoload 速度，还可能误扫测试文件
• 可以用 composer dump-autoload --optimize 合并 classmap 到优化后的 autoload_classmap.php，提升生产环境性能

为什么 vendor/autoload.php 包含后还是报 Class not found

绝大多数情况不是 Composer 配置错了，而是没执行 composer dump-autoload（开发时改了 autoload 必须手动触发），或者用了 --no-autoloader 安装依赖导致 vendor/autoload.php 根本没生成。

另一个高频坑：类文件里写了命名空间，但 composer.json 里映射的前缀和实际命名空间对不上。比如文件 src/Service/UserService.php 里是 namespace AppService;，但配置写成了 "App\": "src/" —— 这是对的；但如果写成 "MyApp\": "src/"，就会找不到。

• 检查类定义的 namespace 和 composer.json 中键名是否完全一致（包括大小写）
• 确认类文件名符合 PSR-4 规范：UserService 类必须存为 UserService.php，不能是 userservice.php（Windows 下可能侥幸成功，Linux 直接失败）
• 用 composer show -p 查看当前 autoloader 是否启用，或临时加一行 var_dump(class_exists('YourClass')); 排查

多目录自动加载本身不难，难的是路径和命名空间之间那层薄薄的对应关系——错一个斜杠、少一个反斜杠、多一个空格，都可能导致类找不到。建议每次加新路径后，立刻跑一遍 composer dump-autoload -v 并用 composer show -p 确认映射已生效，而不是等报错再回头查。