Composer不支持exclude字段，所谓“排除”实为不声明即不加载；files类型无过滤机制，需手动移除；PSR-4通过路径映射控制范围；--no-dev可排除autoload-dev内容；修改后须运行dump-autoload生效。
composer.json 里没有 exclude 字段，别白费劲找
Composer 本身不支持在 autoload 或 autoload-dev 中直接写 "exclude" 或类似配置来“排除”文件。这是常见误解——很多人搜 “composer exclude file”，结果卡在无效配置上。Composer 的自动加载机制是“声明式”的：你只告诉它哪些路径/命名空间要加载，没列的默认就不加载。所谓“排除”，其实是靠不包含它来实现的。
用 files 自动加载时，没法排除单个文件
如果你用的是 "files" 类型（比如加载全局函数），那 Composer 会原样 require 所有列出的文件，没有任何过滤机制。想跳过其中某个，唯一办法是：别把它写进 files 数组里。
- 错误做法：
"files": ["src/helpers.php", "src/deprecated.php"]，然后幻想加个"exclude": ["deprecated.php"]—— 这字段根本不存在，会被忽略 - 正确做法：只写需要的，
"files": ["src/helpers.php"] - 如果
deprecated.php是历史遗留且不能删，又怕被误 require，建议改后缀（如deprecated.php.disabled）或移出files路径
PSR-4 加载下，“排除”本质是调整目录结构或命名空间映射
PSR-4 是主流方式，它的“排除”逻辑藏在路径映射里。比如你想让 src/ 下所有类都加载，但不想加载 src/Tests/ 里的类（尽管它们是 PHP 文件）——那就不该把 Tests 映射进 autoload，而应单独放进 autoload-dev 或干脆不映射。
- 危险配置：
"App\": "src/"→ 会加载src/Tests/ExampleTest.php，哪怕它不该在生产环境出现 - 安全做法：把测试代码挪到
tests/目录，并在autoload-dev中映射："App\Tests\": "tests/" - 如果必须保留在
src/里，就拆开映射："App\": "src/"+"App\Tests\": "src/Tests/"，然后确保生产环境不加载autoload-dev
运行时动态排除？用 composer dump-autoload --no-dev 控制范围
真正起作用的“排除”发生在生成自动加载文件阶段，而不是配置里。比如你把某些类放在 autoload-dev，它们就不会出现在生产环境的 vendor/autoload.php 里。
- 开发环境：
composer dump-autoload→ 包含autoload和autoload-dev - 生产环境：
composer dump-autoload --no-dev→ 只处理autoload，autoload-dev内容全被跳过 - 注意：
--no-dev不影响require-dev的包安装，只影响自动加载规则生成
最易被忽略的一点：修改了 autoload 配置后，必须重新运行 composer dump-autoload（或 install/update），否则变更完全不生效。很多人改完 composer.json 就以为搞定了，结果类还是找不到或不该加载的加载了。
