Composer自动加载不能与手动require混用，必须统一配置autoload并彻底删除所有require/include；否则因类重复定义或加载顺序错乱直接报错。

Composer 自动加载不能直接“替换”手动 require，必须统一归口到 autoload 配置并彻底移除所有手写 require/include，否则会因类重复定义或加载顺序错乱直接报错。

确认当前手动引入方式是否可被替代

先检查项目里哪些文件是靠 require 或 include 加载的：

• 常见位置：入口脚本（如 index.php、cli.php）顶部一堆 require 'vendor/autoload.php' + require 'src/Helper.php' 这类
• 如果这些文件定义了类（尤其是命名空间类），它们就属于自动加载的覆盖范围；如果是纯函数或配置数组，则不能进 autoload，得保留或重构
• 注意 require_once 看似安全，但和 Composer 自动加载混用时，PHP 无法判断“这个类我是不是已经加载过”，极易触发 Fatal error: Cannot declare class XXX because the name is already in use

把类文件纳入 autoload 配置

在 composer.json 中声明源码路径和命名空间映射，这是自动加载生效的前提：

Discussion Composer

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

下载

• 若项目使用 PSR-4（推荐）：

  "autoload": {
    "psr-4": {
      "App\": "src/"
    }
  }

  要求 src/Http/Request.php 内必须有 namespace AppHttp;，且类名为 Request
• 若目录结构混乱、无命名空间，可用 classmap：

  "autoload": {
    "classmap": ["src/", "lib/"]
  }

  运行 composer dump-autoload 后，Composer 会扫描这些路径下所有 PHP 文件并建立类名 → 文件路径的静态映射
• 切勿同时用 psr-4 和 classmap 覆盖同一类名，优先级规则复杂，容易漏加载

清理所有残留的手动引入

迁移核心动作不是“加配置”，而是“删代码”：

• 逐个删除所有显式加载类文件的 require/include（包括 require_once），只保留 vendor/autoload.php 这一行
• 检查测试文件（tests/）、命令行脚本（bin/）是否也偷偷写了 require，这类地方最容易遗漏
• 如果删掉后报 Class 'XXX' not found，说明该类没被正确注册进 autoload：要么文件路径与命名空间不匹配，要么没执行 composer dump-autoload，要么类名拼写错误（注意大小写）
• 对非类文件（如 config/database.php 返回数组），不要硬塞进 autoload，应改用独立加载函数或 DI 容器注入

真正卡住人的往往不是配置怎么写，而是某个 require_once 'src/Utils.php' 躲在第 17 个子命令脚本里没被发现——自动加载生效的前提，是整个调用链路中没有任何一处抢先用 require 把类载入了内存。