真正该用的是 composer install --no-dev --optimize-autoloader --classmap-authoritative，且必须配合精准的 classmap 目录声明和命名空间校验；dump-autoload -o 在 Monorepo 中默认不扫描源码，仅刷新映射表，却会遍历全部 PSR-4 目录导致内存溢出，不重建 classmap 也不读取 classmap 配置，纯属空转。
直接结论：在 Monorepo 场景下，composer dump-autoload -o 不仅无效，还极易触发内存溢出；真正该用的是 composer install --no-dev --optimize-autoloader --classmap-authoritative，且必须配合精准的 classmap 目录声明和命名空间校验。
为什么 dump-autoload -o 在 Monorepo 里会 OOM
这个命令在 Composer 2.x 中默认不扫描源码，只刷新 autoload_static.php 和 PSR-4 映射表——但它仍会尝试“硬编码”所有已知 PSR-4 前缀路径下的类，而 Monorepo 往往包含几十个子包、数百个命名空间、上万 PHP 文件。一旦项目没显式配置 "classmap" 字段，Composer 就退化为遍历全部 psr-4 目录，导致内存峰值飙升。
- 执行
composer dump-autoload -o后，vendor/composer/autoload_classmap.php文件体积超过 5MB？基本等于白跑，且冷启动更慢 - Monorepo 中常见
"App": "packages/app/src/"+"Utils": "packages/utils/src/"等多前缀映射，-o会把每个前缀下所有匹配文件全塞进 classmap，哪怕你只用其中 1% - Windows PowerShell 或 CI 环境中未正确设置
$env:COMPOSER_MEMORY_LIMIT="4G"（等号前后不能有空格），会导致 fallback 到默认 1.5G，瞬间爆内存
Monorepo 下真正有效的 autoload 生成流程
Monorepo 的核心矛盾是“目录多但实际加载少”，不能靠全量扫描，得靠收口控制。关键不是加参数，而是改 composer.json 的 autoload 块：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉所有非生产必需的 autoload 条目：比如
"tests/": ["tests/"]、"docs/": ["docs/"]必须移入autoload-dev - 显式声明
"classmap"，只列真正高频使用的目录，例如："classmap": ["packages/core/src/", "packages/api/src/"] - 合并冗余 PSR-4 前缀：把
"Core\Http": "packages/core/src/Http/"和"Core\Console": "packages/core/src/Console/"合并为"Core\": "packages/core/src/" - 确认每个 PSR-4 命名空间末尾带反斜杠：
"Core\": "packages/core/src/"，写成"Core"或"Core\"（双反斜杠）都会被跳过
CI/CD 中必须固化的关键命令与陷阱
Monorepo 的 CI 流水线最容易在部署阶段翻车，因为本地能过、线上报 Class not found 是常态——根源几乎全是 --classmap-authoritative 开了但 classmap 漏类。
- 必须用：
php -d memory_limit=4G COMPOSER_MEMORY_LIMIT=4G composer install --no-dev --optimize-autoloader --classmap-authoritative - 禁止用：
composer dump-autoload -o替代install；它不重建 classmap，也不读取classmap配置，纯属空转 - GitLab CI / GitHub Actions 中，
COMPOSER_MEMORY_LIMIT必须写在env:块里，不能依赖 runner 默认值；否则即使写了-d，也会 fallback 到 1.5G - 验证是否生效：部署后进容器执行
php -r "var_dump(include 'vendor/composer/autoload_classmap.php');"，看数组长度是否符合预期（比如几百~几千行，而非空或几万行）
容易被忽略的 Monorepo 特有风险点
Monorepo 的结构复杂性会让很多“常规优化”变成雷区：
- 多个子包共用同一命名空间前缀（如都声明
"App\": "src/"），但实际目录分散在不同路径下 → classmap 扫描时只认第一个匹配项，其余类永久漏掉 -
packages/foo/composer.json里定义了"autoload": {"psr-4": {"Foo\": "src/"}}，但根composer.json没 include 它 → 这些类根本不会进任何 classmap - 用了
composer-unused插件但没加--no-plugins→ 它会在每个包安装后触发全量分析，Monorepo 下内存占用翻倍不止 - OPcache 预加载未启用，或
opcache.memory_consumption小于 128M → 即使 classmap 正确，autoload_static.php也缓存不住，每次请求都重新解析
