跳到主要内容

让 AI 帮我读迁移文档,结果踩了个坑

小盐啃文档
小盐啃文档

· 阅读约 3 分钟

九月份的事。组长把 element-ui 升 element-plus 的活丢给我,说先别动手,评估一下工作量。我打开官方那个迁移文档,一眼看下去全是 breaking change,密密麻麻。braking change 我第一次见的时候还以为是"刹车变更",查了下才知道是"破坏性变更"——就是升级完你原来的代码会坏,不是让你刹车。

我英语不行,一段一段抠,抠了四十分钟才看完第一屏,后面还有十几屏。当时已经快六点了,我就想了个懒招:把文档切几大段,一段一段丢给 AI,让它告诉我这里面哪些会影响我们这种 vue2 的 element-ui 老后台。

我本来预期它会回我一堆正确的废话,类似"建议您仔细阅读官方文档"。结果它列得挺细,连 $ELEMENT 这个全局对象被 deprecated 都点出来了。我们项目里确实有地方用 this.$ELEMENT 判 size,我自己抠的时候根本没看见那一段。deprecated 读"迪普瑞凯特"?管他的,反正意思就是不推荐用了,给废弃了。

那一下就有点爽。不是因为它替我干活,是因为我省了两个小时的翻译时间,而且它比我细。

然后后面翻车了。

文档里有一节讲 filter(过滤器?这词还需要翻译吗),说 Vue3 里 filter 被移除了。我把这段丢给它,问它我们代码里 {{ date | formatDate }} 这种写法该怎么改。它给的方案是"改成 computed 属性"。我看了觉得挺合理,还抄到笔记里了。

第二天早上我在项目里全局搜了一下,| formatDate 这种有四十多处,好多组件的表格列里都在用。四十多个 computed,想想就头大。我就回去翻原文那一段,才发现原文说的不是这个:filter 这个语法没了,替代方案是把原来的 filter 函数改成普通方法,模板里直接调 formatDate(date)。computed 是能实现,但列表里每个 item 都得挂一个,一个组件三十个 computed,根本不现实。它把"能跑"和"官方推荐的迁移方式"混在一起说了,还说的很肯定。

我要是照抄,估计得改到半夜,还觉得自己改的一点问题没有。

后来我就学乖了。它给的清单我还是收着,但凡是涉及动代码的地方,我都回去对着原文那一小段再核一遍。就这么核了两天,把文档全核完了,最后给组长报了个三到四天的工期。他说你怎么算这么快。我说我把文档啃完了。

这事之后我对它的看法有点变,但不是"它好厉害"或者"它骗人"那种变。它读英文比我快太多,那份文档我自己抠一个礼拜也抠不完,它两分钟给我一个结构。可它的结构是"大概是这个意思",不是"确定是这样"。我这英语水平刚好卡在中间——能看出它哪句不对,但要花点时间。所以现在是先让它过一遍,再回头补。慢一点,两边加起来还是比硬抠快。

今日单词:deprecated,废弃的,第七次查它了,还是记不住。

小盐啃文档
小盐啃文档

英语不好,硬啃英文文档。今日单词又忘了,明天接着查。

查看主页 →