|
英文原文:Express names in code: Bad vs Clean
編程初學者總是把大量的時間用在學習編程語言、語法、技巧和編程工具的使用上。他們認為,如果掌握了這些技術技巧,他們就能成為不錯的程序員。然而,計算機編程的目的并不是關于精通這些技術、工具的,它是關于針對特定領域里的特定問題創造出相應的解決方案,程序員通過相互合作來實現這些。所以,很重要的一點,你需要能精確的用代碼表達出你的思想,讓其他人通過代碼能明白你的意圖。
讓我們先看看編程大師 Robert C. Martin 的杰作《Clean Code》里的一句話:
注釋的目的是為了彌補代碼自身在表達上的不足。
這句話可以簡單的理解為如果你的代碼需要注釋,最有可能是你的代碼寫的很爛。同樣,如果在沒有注釋的情況下你無法用代碼完整的表達你對一個問題或一個算法的思路,那這就是一個失敗的信號。最終,這意味著你需要用注釋來闡明一部分的思想,而這部分在代碼里是看不出來的。好的代碼能夠讓任何人在不需要任何注釋的情況下看懂。好的編碼風格能將所有有助于理解這個問題的所有信息都蘊含在代碼里。
在編程理論中,有一個概念叫做“自我描述的源代碼”。對于一段代碼,一種常見的自我描述機制是遵循某種非嚴格定義的變量、方法、對象命名規則。這樣做的主要作用就是使源代碼更易讀易懂。所以,也就更容易維護和擴展。
這篇文章里,我將舉出一些例子,說明什么是“不好的代碼”,什么是“清楚的代碼”
命名要能揭示意圖
如何命名,在編程中這永遠都是個老大難問題。有些程序員喜歡簡化、縮短或加密名稱,使得只有他們自己能懂。下面讓我們看一些例子:
不好的代碼:
int d;// 天數 int ds;int dsm;int faid;
it知識庫:代碼里的命名規則:錯誤的和正確的對比,轉載需保留來源!
鄭重聲明:本文版權歸原作者所有,轉載文章僅為傳播更多信息之目的,如作者信息標記有誤,請第一時間聯系我們修改或刪除,多謝。