
团队发现AI生成代码致页面体积膨胀153KiB后自建体积监控
来源标题:The import was 7 KiB. The regression was 153 KiB
一个仅7KiB的代码改动让页面体积增加了153KiB,人工审查未发现异常,最终由PR检查拦截。团队因此着手实现体积守卫机制,并复盘了开发中遇到的问题。此前多次速度优化后的性能退化均与打包体积增长有关。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
AI 辅助编码或者说 vibe coding 如今已是常态,但我不太想再跟大家聊又一个“AI 垃圾”。不过,它确实可能带来一些有意思的结果,而我们正好碰上了。
有一个 PR 里,我们收到了一些乍看之下没问题的改动,人工 review 也没发现任何异常,但我们在 PR 上跑的一项检查发现了问题。一个页面可能膨胀 153 KiB,而新增代码只有 7 KiB。所以这篇文章里,我想跟大家讲讲我们是怎么实现体积守护的,以及开发过程中遇到了哪些问题。
上一篇文章里,我们做了一些显著的改进。说实话,我们一直在做速度优化,有些小有些大,但这是个持续改进的过程。嗯,你改进了某个东西,就真的很想保住这个改进。但有时候我们会注意到 dashboard 上出现了一些退化。
分析了几次之后,我们发现所有退化都和 bundle 体积增长有关。我们决定盯住它,并看看别人是怎么做的。
通常大家要么手动做,要么用 nextjs-bundle-analysis 之类的工具。但它不适合我们:它只读取 Pages Router 的路由,而我们正计划迁移到 App Router。没有适合我们的现成工具。
先说坏消息:Next.js 移除了 sizes、First Load JS 这项统计以及 manifests。按照他们的说法,这些并没有展示 webpack 和 Turbopack 的真实体积。
所以我们当时的情况是:@next/bundle-analyzer 只对 webpack 构建有效,而 next experimental-analyze 只能供人工分析。基于这些库根本无法搭建任何流水线。
嗯,我一明白这一点,就去查了构建之后有哪些产物。几个 grep 和 cat 之后——BOOM,我找到了 route-bundle-stats.json。路由、chunk,我需要的所有数据都在里面。没有压缩后的体积,文件也没有文档,但没关系,我们冒了这个险。
我实现了一个小型 CLI 工具,带预算、压缩、报告对比,都是我们需要的东西。没什么高深的,就是一个解决我们问题的工具。
我想用几句话跟大家分享一下它是怎么工作的。
如果出了什么问题,比如某个 chunk 不存在或者格式变了,工具会告诉你并以错误退出。
嗯,我们的第一版尽可能简单,看:
但这导致我们在实际对比的东西上出了问题。
毕竟我们活在现实世界里:e2e 运行有时会红,开发者有时也不更新自己的分支。
假设 main 前进了几个 commit,其中某个 commit 减小了 bundle 体积。你的分支会检查失败,但你什么都没做错,你只是分支里没有那些 commit。
这在新的 AI 世界里尤其难以解释,所有人都想写点代码、做点原型,或者实现自己脑子里的东西。但他们比开发者经验少一些。这对他们来说很挫败。
说下数字:v1 的失败里大约一半是误报。和 main 同步的分支在 5.7% 的检查中失败,落后 20+ commit 的分支——43%。
嗯,基于我们的经验,我们决定迁移到 merge-base 流程。所以现在是这样工作的,3 个 job:
公开的 GitHub Action 在一个 job 里做同样的事,但它总是重新构建 merge base,而且没有缓存。
我们有一个 PR,里面有一些明显的改动,大部分是 agent 写的。作为产品功能的一部分,agent 抽出了一个新模块并通过 barrel 导出;这是规则之一,因为我们用的是 FSD 架构。于是 4 个文件加上了这个 import:
import { getCanvasImagesSource } from '@/shared/model/canvas'
另一个 PR 里,样式页面的改版被合进了 main。用 main 更新这个 PR 之后变成了这样:
说实话,这纯属巧合。两个 PR 都没做错什么,各自的改动单独看都是合理的。但合在一起——BOOM。
下一步:我们让 agent 读那份报告并找出问题。说实话,agent 在调试的这部分真的很擅长。
它解析了 bundle,发现 barrel 把 engine 代码拉进了样式页面,然后只改了 4 个 import!纯类型 import 留在了 barrel 上,反正 TypeScript 会把它们擦除。review 时,我们把模块移到了它自己的 slice,这样既遵守了 FSD 规则,bundle 也保持轻量:
- import { getCanvasImagesSource } from '@/shared/model/canvas'
- import { getCanvasImagesSource } from '@/shared/model/canvasImages'
每一步 bundle 体积的变化:
最初问题出在哪?source map 显示同样的模块在多个入口点之间被共享,其中一些最终在 bundle 里出现了两次(我猜循环依赖的解析就是这么工作的)。
所以,如果没有 bundle 体积守护,我们的应用整体会增长 200 KiB。当然,我们会从告警里注意到,但它已经会在生产环境里待上一段时间了。
现在,我们只聊了 bundle 体积检查的一面。来看看另一面。
我们新的 bundle 监控方式不仅帮我们拦住坏的改动,也帮我们注意到好的改动。
我给大家举个好例子:有一段时间我们同时维护着两个不同版本的 UI,无法把它们妥善拆分,当然这导致了一些退化。
经过大量工作和几次实验,我们迁移到了新版,之后我们决定删掉旧 UI 的部分,看看有什么变化。我们删了 220 个文件和 19,354 行代码:/projects 的 first-load JS 减少了四分之一(-26%),22 个路由变轻了。
嗯,现在我们有了自己工作的有力证据,也看到了重构能如何影响用户体验。不只是“功能”才能改善用户体验。
这段旅程之后,我们决定把我们的这个小 CLI 对比工具开源。
嗯,它是什么?它是我们用了半年的内部 CLI 工具,我们终于决定分享出来。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。