脚手架升级后，存量前端项目怎么跟？聊聊如何用自动化工具与变更文档拉齐规范

聊一个前端工程化里挺痛、但又容易被忽视的问题：脚手架更新了，存量项目怎么跟进？

很多团队开新项目时规范拉满，但半年过去，老项目就成了“规范孤岛”——ESLint 规则落后三代、构建脚本各写各的、公共依赖版本群魔乱舞。

从我写升级文档和做规范推广的经验来看，光在群里发一句“大家参考 Wiki 升级一下”基本等于零效果。要保证存量工程不掉队，通常有三个进阶阶段：

1. 配置抽包（低自动化）：把 ESLint、Prettier、TSConfig 抽成独立的 npm 包（例如 @team/eslint-config）。存量项目只锁大版本，小更新直接 npm update 搞定。
2. 变更文档配对 Codemod（半自动化）：写 Migration Guide（迁移指南）必须配「代码转换脚本」。文档里列清楚：Before 是什么、After 是什么，然后给一条 npx @team/codemod v2-upgrade 命令自动改写 AST。
3. Bot 自动提 PR（全自动化）：接入 Renovate 或自研脚本，脚手架核心模板更新时，直接向存量项目批量提 PR，并在 CI 里跑一遍自动化测试。

我们目前卡在第 2 到第 3 阶段之间：底层配置容易推，但涉及构建工具（比如从 Webpack 搬到 Vite）或者目录结构调整时，自动化脚本很容易踩存量项目的“魔改特异性”。

想问问大家团队： 你们现在是靠文档驱动老项目升级，还是已经跑通了某套自动化同步机制？面对存量业务项目的抗拒，你们是怎么定推进节奏的？