致來者
2025年12月15日 · 約 567 字
接手過一個別人寫的模塊。
兩千行,一個方法從頭寫到尾,中間沒有分段。變量名是 a1、tmp、data2。
我花了三天,才敢改第一行。
那三天裡我一直在猜:他當時在想什麼?為什麼這裡要多加一個判斷?這個循環為什麼提前跳出去?
猜不出來。他不寫註釋,大概是覺得沒必要——代碼就是註釋。
自己也會變前人
後來自己也變成了"前人"。
三年前寫的一段邏輯,現在打開,第一反應是"這誰寫的"。看清楚才發現是自己。當時覺得理所當然的地方,現在完全想不起來為什麼。
那種感覺很怪。像收到一封自己寫的信,字跡熟悉,內容陌生。
從那以後
寫字會多想一步。
變量名寫全,usrMgr 改成 userManager,多敲幾個字母。函數名寫"做什麼"不寫"怎麼做"。
出錯的地方要留線索。超時、格式不對、沒權限,這三種得能分開,不能統一變成"操作失敗"——那樣等於什麼都沒說。
不可逆的操作前先留退路。遷移前打快照,批量改之前先導出。順利的時候這些動作看著多餘,出事的時候它們是救命的。
吃過虧才長的記性
這些都不是規範要求,是吃過虧之後長出來的。
有次線上出問題,日誌裡只有一句"error"。查了四個小時,最後靠猜。那四個小時我一直在想:當時要是多寫一行,現在是不是已經喝上茶了。
致來者,其實就是寫給未來的自己。
希望那個人打開文件時,不用先花三天猜我。