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 里根本不会出现它们。
- 必须嵌套在
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 规则——这时候排除再准也没用。
