根本原因不是安装失败，而是自动加载映射未更新；需执行 composer dump-autoload（推荐加 -o 参数），并确保 vendor/autoload.php 在入口文件第一行引入、PSR-4 路径与命名空间严格匹配、PHP 版本统一。
composer install 后类仍报 Class not found，根本不是安装失败
90% 的情况是 composer install 确实把包下进了 vendor/，但没更新自动加载映射——它只读 composer.lock 安装依赖，不碰 composer.json 里的 autoload 配置，更不会重写 vendor/composer/autoload_psr4.php。
常见于以下操作后：
- 手动改了
composer.json的autoload段，然后只跑composer install - 从 Git 拉了别人代码，
composer.lock和vendor/已存在，但本地autoload_psr4.php是旧的（比如之前用 PHP 7.4 生成，现在用 8.2 运行） - 团队协作中有人删了
vendor/但没清composer.lock，再install时跳过了 autoload 重建
解决办法只有一个：运行 composer dump-autoload。加 -o 参数还能暴露路径错误，比如输出 Class XXX is not in the class map 就说明 PSR-4 路径根本没被识别。
require 'vendor/autoload.php' 没放对位置，整个 autoload 就没启动
vendor/autoload.php 不是普通文件，它是调用 spl_autoload_register() 注册加载器的“开关”。一旦在它前面写了 new AppService() 或任何类实例化语句，PHP 就会直接报错，不等 autoload 启动。
必须确保：
- 入口文件（如
public/index.php、cli.php）第一行就是require __DIR__ . '/../vendor/autoload.php';（用__DIR__避免相对路径失效） - 没被
if、函数、try/catch包裹——这些结构会让 require 延迟到执行时才触发，而类可能早在那之前就被解析了 - Laravel/ThinkPHP 等框架的入口已内置该行，但升级或迁移时容易被误删；TP8 中若这行在
THINK_PATH . 'base.php'之后，Composer 的 PSR-4 规则会被框架自己的加载器跳过
PSR-4 映射路径和命名空间大小写/斜杠全错，PHP 不报错只静默跳过
Composer 生成的 autoload_psr4.php 是个静态数组，比如 ['App' => ['src/']] 。PHP 运行时靠它拼路径：AppControllerHome → 剥离前缀得 Controller/Home → 拼 src/ 得 src/Controller/Home.php。任何一环错，就找不到文件，且不提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型问题：
- 命名空间漏反斜杠：
"App"不匹配AppController，必须写成"App\" - 路径少斜杠：
"src"会拼成srcController/Home.php，必须写"src/" - Linux/macOS 下大小写敏感：
src/Models/user.php无法加载App\Models\User，文件名必须是User.php - 路径是软链接且 PHP 8.0+ 未启用
follow_symlinks，realpath("src/")返回 false，整条映射被跳过
验证方法：打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀，确认数组值里路径存在且可读。
VSCode 终端 PHP 版本和命令行不一致，autoload 映射生成与运行环境错配
VSCode 内置终端默认调用 PATH 里第一个 php，经常是系统自带的低版本（如 7.4），而你项目要求 PHP 8.2。结果 composer install 在 7.4 下生成 autoload 文件，8.2 运行时因路径解析差异（比如对反斜杠、空目录、软链接的处理）直接跳过映射。
查证方式：
- VSCode 终端执行
which php和php --version - 系统终端同样执行，对比输出
修复步骤：
- macOS/Linux：在 VSCode 设置里搜
terminal integrated default profile，设为zsh或bash，确保加载了~/.zshrc中的 PHP 路径 - Windows：终端右下角点类型，切到
Command Prompt或Git Bash，别用 PowerShell（不继承用户 PATH） - 确认一致后，删掉
vendor/和composer.lock，重新composer install
最隐蔽的坑是：autoload.php 加载了，映射也存在，但 PHP 8.2 的 realpath() 对路径做了静默修正，导致拼出来的文件路径根本不存在——这时连错误都不报，只返回 Class not found。
