composer dump-autoload --optimize 卡住主因是盲目递归扫描宽泛路径，触发海量 i/o 系统调用；应收窄 autoload 路径、剔除非类目录、验证 php 文件数量，并用 composer install --no-dev --optimize-autoloader --classmap-authoritative 替代单独 dump。
为什么 composer dump-autoload --optimize 在扫描大类库时卡住或耗尽磁盘 I/O
根本不是 Composer 本身慢，而是它老老实实递归遍历你 composer.json 里写的每一个路径——哪怕里面混着 node_modules/、docs/ 或空目录，它都照扫不误。一次完整 classmap 扫描可能触发数万次 stat() 和 readdir() 系统调用，I/O 队列直接堵死。
- 检查
autoload.classmap和autoload.psr-4是否包含宽泛路径（如"."、"src"而非"src/"） - 确认没把
tests/、vendor/bin/、resources/这类非类目录写进 autoload 声明 - 警惕空命名空间前缀：比如
"" : "legacy/"会让 Composer 把整个legacy/当根目录全量扫描 - 第三方包若自带 PSR-4 声明但实际类文件分散在子目录（如
monolog/src/Monolog/Handler/），Composer 会为每个子目录单独scandir()，放大 I/O 压力
如何让 classmap 扫描跳过非 PHP 文件和无效目录
Composer 不支持 glob 模式或排除列表，唯一可控方式是收窄扫描入口。别指望 --optimize 自动过滤，它只认你明确列出的路径。
- 把
"src/"拆成具体子目录：["src/Domain/", "src/Infrastructure/", "src/Application/"]，避免扫描src/Tests/或src/Assets/ - 删掉所有未实际存放类的路径声明，哪怕只是留着占位（如
"app/Commands/"目录为空，就别写进classmap） - 对稳定第三方库，直接指定其
src/或lib/下真实含类的路径，例如：["vendor/ramsey/uuid/src/"]，而非整个vendor/ramsey/uuid/ - 用
find vendor/monolog/monolog/src -name "*.php" | wc -l验证目标路径下确实有数百个类文件，再决定是否纳入
扫描期间磁盘爆满？检查 autoload_files 和 class_alias 干扰
autoload_files 列表里的 PHP 文件会被无条件加载（非类定义），如果其中包含 require_once 动态引入大量文件，或执行了 file_put_contents() 日志写入，就会在 dump-autoload 阶段意外触发磁盘写入风暴。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
autoload.files数组中是否混入了初始化脚本、配置生成器或调试工具（如"src/helpers.php"里调用了generate_cache()） - 确认没有在
files加载的文件中使用class_alias()—— Composer 无法静态分析这类动态别名，会跳过对应类的 classmap 收录，导致后续启用--classmap-authoritative时直接报错 - 运行
strace -e trace=write,openat -f composer dump-autoload -o 2>&1 | grep -E "(write|openat.*\.php)"，看是否有异常文件写入或重复打开行为
真正生效的磁盘友好型命令组合
别用 composer dump-autoload -o 单独跑，它不重扫路径；也别信 "optimize-autoloader": true 这种配置项，它只改默认值，不触发实际构建。
- 生产部署必须走
composer install --no-dev --optimize-autoloader --classmap-authoritative—— 这才是唯一会清空旧映射、重新扫描、生成精简 classmap 的完整流程 - CI 中若需增量更新 autoload，用
composer dump-autoload --optimize-autoloader --no-dev --classmap-authoritative（注意是--optimize-autoloader，不是-o） - 扫描前先清理无关文件：
find src/ -name "*.md" -delete; find src/ -name "README*" -delete，减少readdir()返回条目数 - 大项目建议加
--ignore-platform-reqs避免因扩展缺失中断扫描，但得确保目标环境已装好 opcache 和 APCu
classmap 扫描不是 CPU 密集型任务，而是 I/O 密集型操作。路径越窄、文件越纯、权限越稳，生成速度越可预期。一旦发现 vendor/composer/autoload_classmap.php 体积暴涨但类数没增加，基本就是扫进了不该扫的目录或文件类型。
