臨別贈(zèng)言

請(qǐng)務(wù)必保持代碼的一致性

如果你正在編輯代碼, 花幾分鐘看一下周邊代碼, 然后決定風(fēng)格. 如果它們?cè)谒械乃阈g(shù)操作符兩邊都使用空格, 那么你也應(yīng)該這樣做. 如果它們的注釋都用標(biāo)記包圍起來(lái), 那么你的注釋也要這樣.

制定風(fēng)格指南的目的在于讓代碼有規(guī)可循, 這樣人們就可以專(zhuān)注于”你在說(shuō)什么”, 而不是”你在怎么說(shuō)”. 我們?cè)谶@里給出的是全局的規(guī)范, 但是本地的規(guī)范同樣重要. 如果你加到一個(gè)文件里的代碼和原有代碼大相徑庭, 它會(huì)讓讀者不知所措. 避免這種情況.

Revision 2.59
Amit Patel
Antoine Picard
Eugene Jhong
Gregory P. Smith
Jeremy Hylton
Matt Smart
Mike Shields
Shane Liebling