Firn·Touch 閒說 · 全部文章
繁體中文

致來者

2025年12月15日 · 約 567 字

接手過一個別人寫的模塊。

兩千行,一個方法從頭寫到尾,中間沒有分段。變量名是 a1、tmp、data2。

我花了三天,才敢改第一行。

那三天裡我一直在猜:他當時在想什麼?為什麼這裡要多加一個判斷?這個循環為什麼提前跳出去?

猜不出來。他不寫註釋,大概是覺得沒必要——代碼就是註釋。

自己也會變前人

後來自己也變成了"前人"。

三年前寫的一段邏輯,現在打開,第一反應是"這誰寫的"。看清楚才發現是自己。當時覺得理所當然的地方,現在完全想不起來為什麼。

那種感覺很怪。像收到一封自己寫的信,字跡熟悉,內容陌生。

從那以後

寫字會多想一步。

變量名寫全,usrMgr 改成 userManager,多敲幾個字母。函數名寫"做什麼"不寫"怎麼做"。

出錯的地方要留線索。超時、格式不對、沒權限,這三種得能分開,不能統一變成"操作失敗"——那樣等於什麼都沒說。

不可逆的操作前先留退路。遷移前打快照,批量改之前先導出。順利的時候這些動作看著多餘,出事的時候它們是救命的。

吃過虧才長的記性

這些都不是規範要求,是吃過虧之後長出來的。

有次線上出問題,日誌裡只有一句"error"。查了四個小時,最後靠猜。那四個小時我一直在想:當時要是多寫一行,現在是不是已經喝上茶了。

致來者,其實就是寫給未來的自己。

希望那個人打開文件時,不用先花三天猜我。