← 全部笔记
发布于 · 2026年7月27日

命名会把思考带向不同方向

名称不只是标记事物,它还决定人们从哪里开始理解问题。

一位同事休假前,把一个工单交接给了我。

标题写清了要改什么,却没有写清这项改动属于哪个功能。交接时,我得到了一种解释;后来和产品负责人沟通,才发现我们理解的并不是同一个问题。

两种解释都不算离谱,但都少了一个关键点:这个问题到底发生在系统的哪里。

转折来自另一位很熟悉这块产品的同事。他没有直接给我答案,只是告诉我应该先看哪一部分。

方向一旦正确,代码反而很容易理解。真正耗时间的,不是实现,而是找到正确的上下文。

我们常把名称当成一个标签,用来区分工单、字段和组件。但它还有一个更重要的作用:告诉后来的人,这件事属于哪里。

一个名称在正文开始前,就已经影响了读者的判断。它会暗示问题和哪个功能有关、应该从哪部分系统开始看、哪些背景值得优先考虑。

这些信息不清楚时,人们并不只是误解了几个词,而是可能从错误的位置开始分析。

如果工单标题一开始就包含功能名称,这次偏差大概率不会发生。接手的人不必重新拼上下文,也不会先在错误方向上花时间。

命名不会让系统变简单,但它可以缩短问题与正确上下文之间的距离。