生成的文件一保存就被插件重排 import,模板里的分组顺序全乱,团队里装了插件的 5 个人每次提交都带无关 diff。碰到这种情况,我一般先确认改动有没有真的生效。

原因不复杂,IDE 插件用的是自己的默认规则,项目里没有提交格式化配置。生成器输出后也没有按项目配置格式化,两边规则不一致。

「生成器 IDE 冲突」这类改动最怕改一半,回滚脚本先准备好,再动生产。改完顺手把文档补一句,省得下次自己重新推一遍。

npx prettier --check "src/**/*.ts"
npx eslint --fix "src/**/*.ts"
# .vscode/settings.json 里指定 formatter

监控和日志的时间要对上,时区不一致会多绕很大一圈。临时改动用注释写上日期和原因,过两周自己都记不清为什么这么写。

动手前把原文件复制一份带时间戳,出问题立刻换回去,比现场分析快得多。

具体做法是,项目根目录提交统一的格式化配置和编辑器配置;生成器输出时按同一份配置格式化;在配置里显式声明 import 排序规则;提交前用 lint-staged 统一跑一遍。

最后用这个标准收尾,不同机器上保存生成的文件不产生 diff 提交里只剩业务改动。

作者 9823189