Python风格规范.pdfVIP

Python风格规范 分号 Tip 不要在⾏尾加分号, 也不要⽤分号将两条命令放在同⼀⾏. ⾏长度 Tip 每⾏不超过80个字符 例外: 1. 长的导⼊模 语句 2. 注释⾥的URL 不要使⽤反斜杠连接⾏. Python会将 圆括号, 中括号和花括号中的⾏隐式的连接起来 , 你可以利⽤这个特点. 如 果需要, 你可以在表达式外围增加⼀对额外的圆括号. Yes: foo_bar(self, width, height, color=black, design=None, x=f emphasis=None, highlight=0) if (width == 0 and height == 0 and color == red and emphasis == strong): 如果⼀个⽂本字符串在⼀⾏放不下, 可以使⽤圆括号来实现隐式⾏连接: x = ( his will build a very long long long long long long long long string) 在注释中，如果必要，将长的URL放在⼀⾏上。 Yes: # See details at # http://www ./us/developer/documentation/api/cont No: # See details at # http://www ./us/developer/documentation/api/conte # v2.0/csv_file_name_extension_full_specification.html 注意上⾯例⼦中的元素缩进; 你可以在本⽂的 缩进 部分找到解释. 括号 Tip 宁缺⽏滥的使⽤括号 除⾮是⽤于实现⾏连接, 否则不要在返回语句或条件语句中使⽤括号. 不过在元组两边 使⽤括号是可以的. Yes: if foo: bar() while x : x = bar() if x and y : bar() if not x : bar() return foo for (x, y) in dict.items(): ... No: if (x): bar() if not(x): bar() return (foo) 缩进 Tip ⽤4个空格来缩进代码 绝对不要⽤tab , 也不要tab和空格混⽤. 对于⾏连接的情况, 你应该要么垂直对齐换⾏的 元素(见 ⾏长度 部分的⽰例), 或者使⽤4空格的悬挂式缩进(这时第⼀⾏不应该有参数): Yes: # Aligned with opening delimiter foo = long_function_name(var_one, var_two, var_three, var_four) # Aligned with opening delimiter in a dictionary foo = { long_dictionary_key : value1 + value2, ... } # 4-space hanging indent; nothing on first line foo = long_function_name( var_one, var_two, var_three, var_four) # 4-space hanging indent in a dictionary foo = { long_dictionary_key : long_dictionary_value, ... } No: # Stuf