格式
5.1 格式的目的
拋掉“讓代碼能工作”的想法,今天編寫的功能,可能在下個版本中修改,但代碼的可讀性卻會對以后可能的修改行為產生深遠的影響,
5.2 垂直格式
5.2.1 向報紙學習
名稱應當簡單且一目了然,源文件最頂部應該給出高層次概念和算法,細節應該往下漸次展開,知道找到源文件中最底層的函數和細節
5.2.2 概念間垂直方向上的區隔
代碼都是從上往下讀,從左往右讀。每行展現一個表達式或一個字句,每組代碼行展示一條完整的思路。這些思路用空白行隔開,這條及其簡單的規則極大地影響代碼的視覺外觀,每個空白行都是一條線索,標示出新的獨立的概念,你的目光總會停留于空白行之后那一行
5.2.3 垂直方向上的靠近
5.2.4 垂直距離
5.2.5 垂直順序
我們想自上向下展示函數調用依賴順序,被調用的函數應該放在執行調用的函數小面,這樣就建立一種自頂向下貫穿源代碼模塊良好信息流
5.3 橫向格式
遵循無需拖動滾動條到右邊的原則
5.3.1 水平方向上的區隔與靠近
5.3.2 水平對齊
5.3.3 縮進
5.3.4 空范圍
5.4 團隊規則
包括什么地方放置括號,縮進幾個字符,如何命名類,變量和方法,等等,把鬼咋編寫進IDE的代碼格式功能,絕對不要用各種不同風格來編寫源代碼,這樣會增加其復雜度
5.5 鮑勃大叔的格式規則
Paste_Image.png