必须引入vendor/autoload.php且正确配置autoload才能new类；常见class not found因未引入、未dump-autoload或psr-4路径与命名空间不匹配；psr-4适合规范项目，classmap适合遗留代码；files方式用于全局函数但会无条件预加载。
不手动 require 就能 new 类，前提是 autoload 配置正确且 vendor/autoload.php 被引入——漏掉任一环节，类就“不存在”，不是报错，是压根没机会触发加载逻辑。
为什么 new 一个类却提示 Class not found
常见错误现象：类文件明明存在、命名空间也对，但运行时仍报 Class 'AppServicesUserService' not found。
根本原因往往不是配置写错了，而是：
– 没在入口文件（如 index.php）中 require_once 'vendor/autoload.php'；
– 或者改了类路径/命名空间后，没执行 composer dump-autoload；
– 或者 composer.json 里写的 psr-4 映射前缀和实际 namespace 不一致（比如配了 "App\": "src/"，但类里写的是 namespace MyAppServices;）。
PSR-4 要求命名空间前缀 + 目录结构严格对应，AppServicesUserService 必须落在 src/Services/UserService.php，少一层目录或拼错字母都会失败。
psr-4 和 classmap 两种配置怎么选
使用场景决定选型：
-
psr-4：适合常规项目结构，类按命名空间组织，开发中频繁增删类——只需保证目录和命名空间对齐，无需每次手动刷新映射； -
classmap：适合遗留代码、无命名空间的类、或目录结构混乱但又不想重构的情况——它靠扫描物理路径生成全量类名 → 文件路径映射表，执行composer dump-autoload后才生效。
性能上，psr-4 是规则匹配，类越多越快；classmap 是数组查表，初始加载稍快但生成成本高，且新增类必须重跑命令。
示例配置差异：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
vs
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"autoload": {
"classmap": ["legacy/", "helpers/"]
}
}
修改 autoload 后为什么新类还是加载不了
因为 Composer 不监听文件变化，autoload 映射是静态生成的。
以下情况必须手动执行：
– 新增类文件或移动类位置；
– 修改 composer.json 中的 autoload 配置；
– 更改类的 namespace 声明。
执行命令：
– 开发阶段推荐加 -o 参数： composer dump-autoload -o（生成优化版映射，跳过动态解析）；
– 如果只是调试，不加 -o 也行，但上线前务必加；
– 注意： composer install 或 composer update 会自动触发 dump-autoload，但仅限于它们感知到的变更。
files 方式适合什么场景
files 是唯一一种「无条件预加载」的方式，适用于全局函数、常量定义、配置数组等不能用类封装的内容。
例如你有一堆辅助函数放在 src/Helpers/functions.php，里面全是 function str_slug() { ... }，没有 namespace，也没 class，这时只能靠 files：
{
"autoload": {
"files": ["src/Helpers/functions.php"]
}
}
执行 composer dump-autoload 后，这些文件会在每次请求时被无条件 include_once。缺点也很明显：无法按需加载，会拖慢所有请求，慎用于大文件或含副作用的代码。
真正容易被忽略的是：一旦用了 files，它就永远在 autoload 流程里，哪怕你只 new 一个 UserService，functions.php 也会被载入——这点和 PSR-4/classmap 的懒加载本质不同。
