exclude-from-classmap仅在classmap模式下生效，需配合composer dump-autoload --optimize使用，对PSR-4/PSR-0无效；真正控制加载范围应精简autoload路径而非依赖排除。
Composer 排除指定目录不是靠“排除”，而是靠“不包含”——你得明确告诉它哪些路径该扫描，而不是让它的自动加载器去绕开某个文件夹。
composer.json 里用 autoload 的 exclude-from-classmap 不起作用？
这是最常踩的坑：exclude-from-classmap 只对 classmap 类型生效，且仅在运行 composer dump-autoload --optimize（即生成优化后的 vendor/composer/autoload_classmap.php）时参与过滤。它对 psr-4 或 psr-0 完全无效。
-
psr-4加载完全依赖命名空间前缀与路径映射，只要某 PHP 文件落在映射路径下、且符合命名空间规则，就会被加载——根本不会看它是不是在“想排除”的子目录里 - 想让
tests/或examples/不进自动加载，最稳妥做法是：别把它们写进autoload段里 - 如果已误配（比如
"": "src/"这种宽泛映射），exclude-from-classmap也救不了——它只删 classmap 条目，不阻止 PSR 发现文件
如何真正跳过 vendor/ 外的特定目录（如 docs/、scripts/）？
关键在 autoload 的路径定义要精确，而非宽泛。Composer 不提供“黑名单”机制，只有“白名单”式声明。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误写法：
"psr-4": {"App\": "src/"}+ 把docs/放在src/下 → 它会被扫描（只要含class或interface声明） - 正确做法：把
docs/移出所有autoload路径；若必须共存，改用autoload-dev单独管理测试/文档相关代码 - 若需保留某些工具脚本但不希望被加载，确保它们不以
.php结尾，或不含可被解析的类结构（比如纯函数文件不声明namespace，且未被任何require显式引入）
镜像加速后 composer install 仍慢？检查是否触发了冗余 autoload 扫描
镜像只加速包下载，不减少本地 autoloader 构建耗时。当 composer dump-autoload 扫描成千上万个文件（尤其含大体积非代码目录），速度会骤降。
- 运行
composer dump-autoload -v，观察输出中是否反复进入node_modules/、.git/、vendor/bin/等无关目录——说明你的autoload路径太宽，或项目根目录混入了不该存在的 PHP 文件 -
composer config --global discard-changes true和镜像无关，别指望它加快 autoload - 真正有效的是：在项目根目录放一个
composer.json的autoload段只写最小必要路径，并确认vendor/外无意外的.php文件
为什么 autoload-dev 里的路径不影响生产环境自动加载？
因为 Composer 默认只加载 autoload 段内容；autoload-dev 仅在 composer install --dev 或 dump-autoload 未加 --no-dev 时才合并进去。这点常被忽略，导致误以为 dev 目录“已被排除”。
-
autoload-dev是独立白名单，不是过滤器。把它当“额外加载项”理解更准确 - 若想彻底隔离（比如
tests/绝不进生产 autoload），确保它只出现在autoload-dev，且生产部署时加--no-dev - 注意：某些 CI 工具默认带
--no-dev，但本地composer install默认包含 dev，行为不一致容易引发本地能跑、线上报Class not found
真正要控制自动加载范围，核心就一条：别依赖“排除”，老老实实把 autoload 的路径收窄到最小必要集合。任何试图在宽路径上打补丁的做法，都会在换环境、升级 Composer 或加新包时突然失效。
