Composer无全局排除开关，需依配置项、作用域与缓存刷新协同：autoload.exclude仅限5.0+对PSR-4/PSR-0生效；exclude-from-classmap专用于classmap；autoload-dev实现环境隔离；files类需手动删条目；务必执行dump-autoload。

Composer 没有全局“排除自动加载”的开关，所谓“排除”，本质是选对配置项 + 控制作用域 + 刷新缓存——写错位置、版本不匹配、忘了 dump-autoload，三者任一都会让排除失效。

autoload.exclude 只在 Composer 5.0+ 对 PSR-4/PSR-0 生效

这个字段看起来最直白，但限制最多：它只过滤 psr-4 和 psr-0 扫描出的类，且仅 Composer 5.0.0 及以上才识别。低于该版本（比如仍在用的 2.x 或 4.x）写进去完全被忽略。

• 检查版本：composer --version，不是 5.0.0+ 就别浪费时间配它
• 路径必须相对 composer.json 根目录，例如想排除 tests/Stub/，得写 "tests/Stub/"，不能写 ./tests/Stub/ 或 ../tests/Stub/
• 不支持通配符 ** 或 *.php，只认字面路径；末尾斜杠推荐加上，避免 "tests/Stub" 错误匹配到 tests/Stub.php
• 它对 classmap 和 files 类型完全无效——如果这些地方还挂着你要排除的路径，类照常被加载

exclude-from-classmap 是 classmap 场景下的唯一可靠手段

当你用了 classmap（显式声明或通过 dump-autoload -o 自动生成），且想跳过某些文件或目录时，exclude-from-classmap 是唯一正解。它在扫描阶段就剔除目标，生成的 autoload_classmap.php 里根本不会出现它们。

Discussion Composer

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

下载

• 必须嵌套在 autoload 或 autoload-dev 块内，不能放在外层；例如：

  "autoload": {
    "classmap": ["src/"],
    "exclude-from-classmap": ["src/Tests/", "src/Utils/LegacyHelper.php"]
  }
  

• 路径区分大小写，且必须相对于项目根目录；"src/Tests/" 和 "src/tests/" 是两个路径
• 支持 * 通配符（如 "src/legacy/*"），但不支持 **；目录需带尾部斜杠，否则可能漏掉同名文件
• 如果同一类同时被 psr-4 和 classmap 覆盖，排除只影响 classmap 条目，psr-4 加载仍有效

autoload-dev 不是“排除”，而是环境级隔离

多数人想“排除”的其实是测试桩、CLI 工具、示例代码——这些本就不该进生产环境。与其费劲排除，不如直接挪到 autoload-dev，用 --no-dev 天然隔绝。

• 把 tests/、stubs/、examples/ 全部移到 autoload-dev.psr-4 下，例如：

  "autoload-dev": {
    "psr-4": {
      "App\Tests\": "tests/",
      "App\Stub\": "tests/Stub/"
    }
  }
  

• 生产部署执行 composer install --no-dev，这些路径压根不会写入 vendor/autoload.php
• 兼容所有 Composer 版本，IDE 补全和静态分析不受影响，比各种 exclude 更干净
• 注意：--no-dev 不会删除磁盘上的文件，只是不注册 autoload 规则；如需删文件，得靠 post-install-cmd 脚本

files 类型排除只能靠手动删条目

autoload.files 是硬编码引入的 PHP 文件列表，没有 exclude 机制。想让某个文件不被每次请求都加载，唯一办法就是从数组里把它拿掉。

• 打开 composer.json，定位到 autoload.files 数组
• 找到要禁用的路径，例如 "src/Helpers/GlobalFunctions.php"，整行删除
• 运行 composer dump-autoload，否则旧的 autoload_files.php 仍会 require 它
• 如果只是临时跳过，可在该文件内部加条件判断（如 if (PHP_SAPI !== 'cli') { return; }），但这属于运行时控制，不是 Composer 层面的排除

最容易被忽略的是：改完 composer.json 后不执行 composer dump-autoload，或者没意识到 classmap 缓存可能残留旧映射；更隐蔽的是，硬编码 require 或其他 autoloader（比如框架自带的）绕过了 Composer 规则——这时候排除再准也没用。