臨別贈言

請務必保持代碼的一致性

如果你正在編輯代碼, 花幾分鐘看一下周邊代碼, 然後決定風格. 如果它們在所有的算術操作符兩邊都使用空格, 那麼你也應該這樣做. 如果它們的註釋都用標記包圍起來, 那麼你的註釋也要這樣.

制定風格指南的目的在於讓代碼有規可循, 這樣人們就可以專注於”你在說什麼”, 而不是”你在怎麼說”. 我們在這裡給出的是全局的規範, 但是本地的規範同樣重要. 如果你加到一個文件裡的代碼和原有代碼大相逕庭, 它會讓讀者不知所措. 避免這種情況.

Revision 2.59

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