別說雙關語

別說雙關語

別說雙關語

Intro

避免使用同一字詞代表兩種不同目的。使用同一字詞,來代表兩種不一樣的想法,
基本上就是雙關語。

為了一致性,某人可能決定使用字詞add,但實際上卻沒有增加的意思。
ex:假設我們有許多類別的add方法,是用來相加或相連兩個現有的值,
然後形成新的值。

如果一個新的類別方法跟add原本的語意不同,請使用像insert、append
之類的名稱。

身為程式碼的作者,我們的目標是讓我們的程式碼盡可能易於理解。我們
希望程式可以被快速瀏覽,而不需要花時間奮力苦讀。就像大眾在閱讀受
歡迎的平裝版書籍,作者有責任將程式的意涵闡述清楚,而不是像學者
閱讀學術論文般,得從中努力挖掘出真正的含意。