exclude-from-classmap仅对显式声明的classmap生效，非全局黑名单；若仅配置psr-4，该字段被忽略；路径须严格字面匹配、区分大小写、目录带尾斜杠，且不支持通配符。
exclude-from-classmap 只对显式声明的 classmap 生效
它不是全局黑名单，也不是 PSR-4 的排除开关。如果你只配了 psr-4，哪怕写了 "exclude-from-classmap": ["tests/"]，Composer 也会直接忽略——因为没地方可排除。
必须先在 autoload.classmap 或 autoload-dev.classmap 里明确列出要扫描的路径，exclude-from-classmap 才会在 dump-autoload 阶段起作用。
- ✅ 正确：
"classmap": ["src/", "lib/"], "exclude-from-classmap": ["lib/TestHelpers.php", "lib/legacy/"] - ❌ 无效：只有
psr-4，却加了exclude-from-classmap - ⚠️ 注意：
autoload-dev.classmap下的exclude-from-classmap只影响 dev 模式下的扫描，上线时若用了--no-dev，这些排除项不生效
路径写法必须严格匹配 classmap 扫描范围
Composer 不会帮你补斜杠、猜大小写或展开通配符。路径是字面量匹配，且区分大小写。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 目录必须带尾部
/，写成"tests/Stub/"✅，写成"tests/Stub"❌（可能误匹配tests/Stub.php） - 文件路径要完整，如
"src/Utils/LegacyHelper.php"，不能简写为"LegacyHelper.php" -
"lib/legacy/"≠"lib/Legacy/"—— Linux 部署时大小写不一致，类就找不到了 - 不支持
**或*（即使你看到某些文档说支持 glob，那仅限于 classmap 路径本身，exclude-from-classmap从不解析通配符）
排除后仍加载？先确认是不是 classmap 在干活
“Class not found” 是常见错觉；更常见的是类被加载了，但你不希望它被加载——比如测试桩类意外参与生产逻辑。
- 运行
composer dump-autoload -v，看输出里有没有类似Skipping file lib/TestHelpers.php (excluded)的提示 - 打开
vendor/composer/autoload_classmap.php，搜索目标类名，确认它是否真的没出现在数组里 - 如果还在，说明排除没生效——检查是否拼错路径、大小写、漏了
/，或根本没进 classmap 扫描范围 - 如果已排除但仍能 new 出来，大概率是其他 autoloader 干预（比如手动
require、files加载、或 OPCache 缓存了旧映射）
生产环境慎用 --classmap-authoritative + exclude-from-classmap
这个组合看似高效，实则脆弱。一旦排除了某个类，又在运行时动态依赖它（比如通过反射、class_alias 或第三方库内部逻辑），就会直接 Fatal error: Class not found。
-
--classmap-authoritative意味着 autoloader 完全跳过 PSR-4 fallback，只信autoload_classmap.php - 而
exclude-from-classmap让这张表更“薄”，但也更“窄” - Docker 构建中写
RUN composer install --classmap-authoritative却忘了加--optimize-autoloader，会导致映射表为空，所有类都挂掉 - 真正安全的做法：开发期用普通 classmap + exclude，上线前用
composer dump-autoload -o验证，再配合--classmap-authoritative部署
use 或 new，只管 dump 那一刻的文件系统状态和配置字面量。路径写错、大小写差一位、多一个点少一个斜杠，都会让排除静默失效。 
