exclude-from-classmap能减小自动加载体积，因为它在生成classmap时跳过指定路径，避免将测试类、示例代码等无用PHP文件写入autoload_classmap.php，从而减少该文件大小和解析开销；它仅影响classmap生成，对PSR-4/PSR-0加载逻辑无干扰。
为什么 exclude-from-classmap 能减小自动加载体积？
Composer 的 classmap 自动加载器会扫描所有声明在 "autoload": {"classmap": [...]} 或通过 "autoload": {"psr-4": {...}} 隐式包含的目录，把每个 PHP 文件里的类名和文件路径写进 vendor/composer/autoload_classmap.php。这个文件越大，PHP 每次请求时加载和解析它的时间就越长——尤其在低配环境或 CLI 场景下感知明显。
exclude-from-classmap 不是跳过自动加载，而是让 Composer 在生成 classmap 时不扫描指定路径，从而避免把测试类、示例代码、文档、.php 临时文件等无用类塞进 classmap。
它只影响 classmap 生成行为，对 PSR-4/PSR-0 加载逻辑完全无干扰，也不改变运行时行为。
怎么在 composer.json 中正确配置 exclude-from-classmap？
该字段必须放在根级 "autoload" 或 "autoload-dev" 下，值为字符串数组，路径相对于项目根目录（不是 vendor）。
- 路径末尾不加
/，但支持通配符*（仅匹配单层目录，不递归） - 推荐用相对路径，如
"tests/ExampleTest.php"或"docs/*"；绝对路径或../会被忽略 - 不能排除整个 PSR-4 命名空间根目录（比如你设了
"App\": "src/"，就不能把"src/"加进 exclude）——否则类将彻底无法被加载 - 修改后必须运行
composer dump-autoload（或composer install/update）才会生效
示例：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"autoload": {
"psr-4": {
"App\": "src/"
},
"exclude-from-classmap": [
"tests/",
"examples/",
"legacy/*",
"src/Contracts/Stub.php"
]
}
}
哪些目录最值得用 exclude-from-classmap 排除？
重点排除那些「有 .php 文件但不提供生产环境所需类」的路径：
-
tests/和Tests/：测试类通常带Test后缀，不会被业务代码引用，却常占 classmap 体积 20%+ -
examples/、demo/：示例代码往往结构松散、命名不规范，极易被 classmap 扫描进来 -
docs/、resources/、assets/：若混入了 .php 文件（比如模板脚本或生成器），必须排除 -
*.php单文件（如build.php、deploy.php）：这类脚本不在命名空间下，又容易被 classmap 误抓
注意：vendor/ 下的包不受该项目 exclude-from-classmap 影响；要优化第三方包体积，得去对应包的 composer.json 提 PR 或用 composer config --global fxp.asset-installer.enabled false 等方案。
排除后怎么验证 classmap 是否真的变小了？
别只看文件大小，要确认排除路径里的类是否已从 autoload_classmap.php 中消失：
- 执行
composer dump-autoload -o（加-o强制优化 classmap） - 打开
vendor/composer/autoload_classmap.php，搜索一个你明确排除的类名（比如ExampleTest），确认找不到 - 用
php -r "var_dump(array_keys(include 'vendor/composer/autoload_classmap.php'));" | wc -l统计键数量，对比排除前后的差异 - 如果用了
composer install --no-dev，记得 dev 相关的排除项（在autoload-dev下）不会生效
一个常见陷阱：某些包在 autoload-dev 里注册了 classmap，但你只在根 autoload 下写了 exclude-from-classmap——这时排除无效，必须把排除项也放到 autoload-dev 下。
