根本原因是路径映射未匹配PSR-4规范——Composer仅按composer.json中声明的命名空间与路径关系加载，需确保命名空间末尾双反斜杠、src路径相对项目根目录、类文件名严格匹配类名，且执行composer dump-autoload生效。
为什么 autoload 配置后类还是找不到？
根本原因通常是路径映射没对上——Composer 不会自动扫描目录，它只认 composer.json 里明确声明的命名空间与路径关系。常见错误包括：用相对路径（如 ./src）但没加 ./ 前缀、命名空间末尾多写了反斜杠、src/ 目录下文件实际命名不匹配类名（比如类叫 Helper，文件却叫 helper.php）。
正确做法是严格遵循 PSR-4 规范：类文件路径 = 命名空间转小写 + 类名 + .php 后缀，且路径在 composer.json 中必须为相对于项目根目录的路径。
示例：AppUtilsFileHelper 对应 src/Utils/FileHelper.php，而非 src/utils/filehelper.php 或 src/Utils/filehelper.php。
怎么配置 PSR-4 自动加载本地 src/ 目录？
编辑项目根目录下的 composer.json，在 autoload 字段中添加 PSR-4 映射：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
注意几个关键点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
App\末尾两个反斜杠是必须的，表示命名空间字面量，不能写成App或App/ -
"src/"是相对于composer.json所在位置的路径，结尾斜杠可选但建议保留，避免歧义 - 改完后必须运行
composer dump-autoload，否则改动不生效；加-o参数可生成优化后的类映射（composer dump-autoload -o） - 如果项目已安装依赖，
dump-autoload不会重装包，只是刷新自动加载逻辑
如何加载非标准结构的类（比如全局函数或单文件类）？
PSR-4 不支持直接加载函数或无命名空间的类。这时要用 files 加载方式，它会在每次请求时无条件包含指定文件：
{
"autoload": {
"psr-4": {
"App\": "src/"
},
"files": [
"helpers/functions.php",
"config/bootstrap.php"
]
}
}
适用场景和限制：
- 适合加载工具函数集、常量定义、启动脚本等纯 PHP 代码文件
- 文件路径同样为项目根目录相对路径
- 被
files包含的文件不能有命名空间声明（否则会报错），也不能重复定义函数 - 所有
files会在 PSR-4 类之前加载，顺序按数组排列，需注意依赖关系
为什么运行时提示 Class 'AppSomething' not found？
除了路径和命名空间不匹配，还有几个高频盲区：
- 忘记执行
composer dump-autoload—— 尤其是在新增类或修改composer.json后 - 类文件里用了
declare(strict_types=1)，但父类或接口未定义，导致解析失败（错误可能不直接指向该类） - IDE 缓存或 OPcache 没刷新，特别是用 Docker 或远程环境时，
composer dump-autoload -o生成的vendor/composer/autoload_classmap.php可能没更新到位 - 使用了 Composer 的
autoload-dev，但当前环境不是开发模式（如没设COMPOSER_DEV_MODE=1），导致测试类无法加载
最稳妥的排查顺序：检查类文件路径 → 核对命名空间 → 运行 composer dump-autoload -vvv 看是否报路径警告 → 查看 vendor/composer/autoload_psr4.php 是否已写入对应映射。
