返回资讯中心
外部精选
软件工程
#开发者实时流

谷歌工程师分享:为可理解性而设计代码

来源标题:Design for Understandability

谷歌工程师在2025年11月的内部代码健康峰会上分享了一种应对LLM生成代码难以理解的思路:像为可测试性设计软件一样,为可理解性而设计。他建议运用契约式设计、类不变式、模块化等方法,让系统能逐块理解,而不是堆成难以维护的泥球。这些理念并不新,但尚未被充分教授和理解。

Hacker News 最新tmsln2026/11/19 · 今天30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

这是我在2025年11月谷歌内部代码健康峰会上做的一次演讲。我把它分享在这里,希望能引发进一步的学习和讨论。

在LLM生成我们大部分代码的世界里,理解这些代码比以往任何时候都更加重要。但面对像谷歌代码库这样庞大而复杂的系统,软件工程师很容易陷入一种习得性无助的模式——你能做的最好的事情就是改改代码,然后祈祷它能通过测试。没有理解,LLM不过是一台全速运转的复杂性生成机器。

有一种更好的方式来应对这个问题。正如我们行业已经学会了为可测试性而设计软件,我们也可以为可理解性而设计。我们可以运用契约式设计、类不变式、模块化等理念,来构建我们能够逐一理解的系统,而不是在大泥球上不断堆砌,然后祈祷它不会整体崩塌。

这容易吗?不容易。但值得吗?绝对值得。这些理念并不新鲜,但它们的教学和传播远远不够,也没有得到应有的深入理解。掌握这些理念,能让我们进入一个对代码更有信心、同时提升开发速度的世界。

大家好,感谢邀请!我们开始吧。

我想用一个问题来开场:如果LLM能写代码,那人类软件工程师还剩下什么?

科技行业正迅速转向让大语言模型来写我们所有的代码。但你可能会说:写代码不就是我们软件工程师的工作吗?那把软件工程师的责任置于何地?软件工程师在LLM之上添加的那个核心的人类元素是什么?

你们每个人对这个问题的答案都会不同,这没关系。但以下是我的看法。

那个必要的人类元素就是判断力。判断代码是否可维护。判断它是否健康。

LLM可以遵循模式,生成看起来像它训练数据中的代码。有时它们能为一段代码提供有用的建议和批评。但那个关键的判断——判断某段代码是否适合其设计目标——仍然取决于你,人类。

因为事情是这样的:今天的LLM仍然是一个毛手毛脚的实习生。有时它产出的代码很好,但有时完全跑偏,需要纠正。你不会在未经仔细审查的情况下就把一个毛手毛脚的实习生的代码合入你的系统,所以对LLM的代码也不应该这样做。

你要对你代码的质量负责,不管你是让LLM生成的,还是用传统方式用手指敲键盘写出来的。

那么这把我们带到了哪里?如果LLM将为我们编写大量代码,那么我们面对的未来是:人类花更少的时间写代码,花更多的时间阅读和理解代码,以确保它达到我们的质量标准。

这意味着,提升理解代码的能力、加快阅读和理解的速度,比以往任何时候都更加重要。

现在:如果你想在某件事上变得更好,为自己设定一个有追求的目标是有帮助的。一个高于你当前技能水平的目标,驱动你每天都变得更好。

以下是我提出的目标:我们应该能够预测每一行代码的行为,而无需运行任何一个测试。

让我再说一遍:我们应该能够预测每一行代码的行为,而无需运行任何一个测试。

我知道你可能在想:“理解每一行代码?不测试?你是认真的吗?!有太多的复杂性和遗留代码,我不可能做到!”

你可能会这么想。如果我们撒手不管、放弃所有控制权,你可能是对的。但我在这里要告诉你,有一种更好的方式。

我们可以把代码设计得可理解。

想想一二十年前,我们曾认为为API中每个公共方法编写多个测试是不可行的。那不是因为我们不想做,也不是因为我们没尝试。而是因为我们没有把代码设计到让那个级别的测试成为可能。但渐渐地,在整个软件行业中,我们改变了实践,为可测试性而设计。今天,为可测试性而设计已经深深植根于我们的文化中,不做反而几乎不可想象。我们可以为可理解性做同样的事情,让我们的代码使我们能够更好地理解它。

我们自己的代码健康指南为可理解性提供了有力的论据。它说:“代码要可持续,就必须能被理解。除非开发者知道系统当前提供了什么、以及需要改变什么来适应新情况,否则无法进行变更。因此,代码健康的关键组成部分包括良好的文档、易于理解的错误信息,以及清晰、简单的代码。”

为可理解性而设计不仅重要,而且是一项可学习的技能。它不是那种你有就有、没有就没有的神奇能力。有具体的、可操作的行动可以用来提升代码的可理解性。

今天我将向你们介绍其中的几个。可以把它看作是为可理解性而设计的“入门套件”。我们还会讨论一个贯穿所有这些实践的总体主题,这样在某个时刻,你就能找到更多为可理解性而设计代码的方法。

我今天要展示的这些理念并不新鲜。但它们的教学远远不够——甚至常常根本没被教过——而且我们大多数人对如何应用它们只有粗浅的理解。我今天的目标是把这种理解稍微加深一点,让它稍微更实用一点,从而启动一个让我们的代码随时间变得更可理解的过程。

那么,让我们开始逐一了解这些“为可理解性而设计”的实践。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →