<p>用 exclude-from-classmap 可排除 classmap 生成时的目录，需在 composer.json 中配置并重新运行 dump-autoload；它对 psr-4 无效，且路径须相对、不以/开头，支持 * 通配符。</p>
composer autoload 排除某个目录：用 exclude-from-classmap 最直接
Composer 默认不会自动“排除”目录，它只管把 classmap、psr-4 或 psr-0 配置里声明的路径扫进去。真想让某个目录彻底不进自动加载逻辑，得靠 exclude-from-classmap —— 它是 classmap 生成阶段的过滤开关，不是 autoload 规则里的“忽略”。
常见错误现象：composer dump-autoload 后，明明没在 psr-4 里配某个测试目录（比如 tests/），但 vendor/autoload.php 还是能加载到里面定义的类，甚至导致命名冲突或报错。
-
exclude-from-classmap只对"type": "classmap"生效，对psr-4无效（psr-4 本身就不扫描未声明路径） - 路径必须是相对于
composer.json所在目录的，且不以/开头；支持通配符*，但不支持** - 如果目录被
psr-4显式映射了（比如"App\Tests\": "tests/"），那exclude-from-classmap压根不生效——得先删掉映射
示例：在 composer.json 的 autoload 或 autoload-dev 下加：
"autoload": {
"psr-4": { "App\": "src/" },
"exclude-from-classmap": ["tests/", "docs/", "scripts/"]
}
psr-4 下不想加载某子目录？别指望自动排除，得手动拆开配置
PSR-4 不支持“排除子目录”，它只认前缀 + 路径映射。比如你写了 "App\": "src/"，那 src/Utils/、src/Tests/ 全都会被纳入扫描范围 —— 即使你根本没打算让 src/Tests/ 里的类被生产环境加载。
使用场景：你想把测试辅助类放在 src/Tests/ 里复用，但不希望它们出现在生产 autoloader 中，避免污染命名空间或意外加载。
- 唯一干净做法：把这类目录单独拎出来，用
autoload-dev管理，生产时完全不注册 - 不要试图在
psr-4里写两个指向同一命名空间的路径（比如同时映射"App\": "src/"和"App\": "src/Tests/"），Composer 会覆盖，行为不可控 - 如果硬要保留在
autoload里，只能改目录名（比如叫src/_test_helpers/）再配合exclude-from-classmap，但不如拆配置清晰
运行时动态跳过某目录？别折腾，autoload 是静态生成的
有人想通过环境变量或条件判断，在 composer.json 里动态控制加载路径 —— 行不通。Composer 的 autoload 文件（vendor/autoload.php 及其生成的 autoload_classmap.php 等）是执行 dump-autoload 时静态生成的，没有运行时逻辑。
常见错误现象：本地开发时一切正常，上线后发现某个目录的类突然找不到，或者反常地被加载了 —— 很可能是因为 CI/CD 流程里漏掉了 composer dump-autoload，或用了不同参数（比如没加 --optimize 导致 classmap 没更新）。
-
composer install --no-autoloader或composer dump-autoload --no-scripts这类命令会影响最终生成结果，务必保持构建环境一致 - 修改
exclude-from-classmap后，必须重新运行composer dump-autoload，否则旧 classmap 缓存仍在 - 如果项目用了 APCu 或 OPcache，记得清除 opcode 缓存，否则可能还在用旧的 autoload 文件
为什么 autoload-files 不适合做“排除”？
autoload-files 是用来强制加载某些 PHP 文件（如函数库、常量定义）的，它和“排除”完全无关。把它当成黑名单用，只会让事情更乱。
容易踩的坑：有人把不想自动加载的目录下所有 .php 文件列进 autoload-files，以为这样就能“提前加载完、后面就不管了”，结果反而导致这些文件在每次请求时都被无条件 include，既没排除，还拖慢启动速度。
-
autoload-files列表里的文件，会在vendor/autoload.php被引入时立即执行，无法按需加载 - 它不参与命名空间解析，也不影响 classmap 或 PSR 查找逻辑
- 真正需要“排除”的目标，永远是不让 Composer 把那些类路径写进 autoload 生成文件里，而不是想办法绕过它
复杂点在于：排除动作发生在不同阶段（classmap 生成 vs psr-4 扫描 vs 运行时加载），而很多人默认它们是一回事。实际得先想清楚——你是不想让某目录进 classmap？还是不想让它响应 PSR-4 命名空间查找？抑或只是不想它在生产环境存在？选错机制，后面全得返工。
