composer dump-autoload 无排除参数,需通过 composer.json 配置实现;exclude-from-classmap 仅对 classmap 生效,不影响 PSR-4;路径须相对项目根目录、区分大小写、推荐尾部斜杠;改配置后必须运行 dump-autoload;测试类应移至 autoload-dev 并配合 --no-dev 使用;重复声明命名空间行为不可控;dump-autoload 报错多因非法 PHP 文件(如 BOM、临时文件)。

没有“排除命令”,composer dump-autoload 本身不接受排除参数;所谓“排除”,必须靠 composer.json 里的配置项 + 重新生成来实现。
exclude-from-classmap 只对 classmap 生效,别误用在 PSR-4 上
很多人加了 "exclude-from-classmap": ["tests/"] 却发现 TestsExample 还能 new 出来——因为这个配置压根不拦 PSR-4。只要 "App\": "src/" 映射存在,而 src/Tests/Example.php 符合命名空间规则,它就会被动态加载。
- 只在你明确用了
"classmap": ["src/", "lib/"]时,exclude-from-classmap才起作用 - 路径必须相对项目根目录,区分大小写,推荐带尾部斜杠:
"tests/",而不是"Tests"或"tests" - 支持
*(如"legacy/*"),但不支持**或正则表达式 - 改完必须运行
composer dump-autoload(或-o),否则vendor/composer/autoload_classmap.php不更新
想让 tests/ 目录彻底不出现在生产 autoload 里?用 autoload-dev
这是最干净、最符合 Composer 设计意图的做法。测试类本就不该进生产环境的自动加载链。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 把
"App\Tests\": "tests/"移到autoload-dev块里,而不是autoload - 生产部署时加
--no-dev:运行composer install --no-dev或composer dump-autoload --no-dev - 此时
vendor/autoload.php根本不会注册App\Tests命名空间,连扫描都不会发生 - 别在
autoload和autoload-dev里重复声明同一命名空间,行为不可控
dump-autoload 报错卡住?先查非法 PHP 文件,不是配置问题
报 Parse error: syntax error, unexpected '' 或直接中断,大概率是 Composer 扫到了不能解析的 .php 文件,比如:
- 带 BOM 头的文件(尤其 Windows 编辑器保存的)
- 临时文件:
config.php.swp、.php.bak、example.php - 不含
<?php的伪 PHP 文件(如模板、Markdown 片段、配置示例) - 语法错误的遗留脚本(
if (true { ...)
解决步骤:
- 加
-vvv查看最后成功扫描的路径:composer dump-autoload -vvv - 临时重命名可疑目录(如
mv tests tests.off)再试 - 确认后,在
autoload或autoload-dev下加"exclude-from-classmap"显式过滤,例如:"exclude-from-classmap": ["tests/example.php", "docs/*.php"] - 删掉所有 autoload 路径下非真实类文件,比依赖排除更可靠
根本不想让某目录参与任何 autoload?别声明,就是最好的排除
Composer 没有“全局排除”开关,它的逻辑极简:没在 autoload 或 autoload-dev 里声明的路径,一律不扫描、不映射、不加载。
- 如果
src/Deprecated/里的类你确定永远不用,就别把它放进任何psr-4映射路径里 - 不要为了“图省事”把整个
src/映射成"App\": "src/",结果又想排除子目录——PSR-4 不支持子目录排除 - 真要共存,就拆开映射:
"App\": "src/App/"+"App\Legacy\": "src/Legacy/",然后只在开发环境加载后者 - 最易被忽略的一点:即使排除生效,硬编码的
require_once 'src/Tests/Helper.php'仍会加载,这和 Composer 无关

















