composer无全局排除功能,实际分三类:archive.excludes仅控制打包时剔除文件,exclude-from-classmap仅对classmap生效且需显式配置classmap,--no-dev仅跳过require-dev包安装和autoload-dev注册,三者互不干扰、不可混用。

Composer 没有“排除文件”功能,所谓“排除”,实际分三类互不干扰的用途:打包时剔除(archive.excludes)、自动加载时跳过(exclude-from-classmap)、依赖安装时绕过(--no-dev 或 replace)。混用会失效,甚至导致 autoload 错乱或 CI 构建失败。
archive.excludes 只控制打包,不影响 install 和 autoload
这个配置只在你运行 composer archive 或某些 CI 打包脚本(如生成 zip/tar)时起作用,对 composer install、autoload、vendor 目录结构完全无感。
- 路径是相对于项目根目录的,支持
**(比如"**/*.log"、"docker-compose.override.yml") - 不能写成
./docs/或vendor/**—— 前者会被忽略,后者根本无效(archive不处理vendor) - 常见误用:把它当
.gitignore用,结果composer install仍把tests/下的类加载进 PSR-4 映射,引发命名冲突
exclude-from-classmap 只对 classmap 生效,PSR-4 完全无视它
如果你没在 autoload.classmap 里显式列出目录(比如 "classmap": ["src/", "legacy/"]),那 exclude-from-classmap 就是摆设。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它只影响
composer dump-autoload -o生成的优化 classmap 文件,不改变任何 PSR-4 行为 - 路径末尾建议加
/(如"tests/"),避免误排除同名文件(test.phpvstest/) - 通配符只支持
*,不支持**;"build/*"有效,"build/**"会被忽略
想让某个目录彻底不参与 autoload?别靠“排除”,靠“不注册”
最干净的做法,是根本不在 autoload 或 autoload-dev 里声明它。Composer 不会扫描未注册的目录。
-
tests/只放进autoload-dev.ps4,业务代码就加载不到它的类 -
bin/、docs/、resources/这类非 PHP 类目录,压根不要写进autoload任何字段 - 别用
files+glob模拟排除——files是白名单式 include,每次请求都include_once,性能差、语义错、还容易漏文件
误删 vendor 下的 tests/ 或 docs/?危险且无效
手动 rm -rf vendor/*/tests 看似省空间,但下次 composer update 会恢复,且可能破坏包完整性校验(如 composer validate 报错)。
- 真正精简
vendor的方式只有两个:composer install --no-dev(跳过 require-dev 包及其 tests/),或推动上游包作者加archive.excludes - 如果某包反复带大量无用文件,优先考虑换包,或提 PR 帮它加
archive.excludes -
composer clear-cache不能解决这个问题,它只清本地下载缓存,不影响已安装的 vendor 结构










