指導原則
命名： 清晰易懂熙涤，代碼風格要一致
函數(shù)： 函數(shù)是抽象的主要機制屑宠，最好一個函數(shù)只做一件事。便于組合 復用绳锅。
目的： 每一行代碼應該有一個明確的目的西饵，減少冗余的代碼。
簡潔： 代碼應該是簡潔明了的鳞芙。
變量命名
Good
goal, score, opp_score = 1 00, 0, 0
greeting = ' hello world'
is_even = lambda x: x % 2
Bad
a, b, m = 1 00, 0, 0
thing = ' hello world'
stuff = lambda x: x % 2
注意字母和數(shù)字
當很明確一個字母是做什么的時候眷柔，使用縮寫的可以的。
Good
i = 0 # a counter for a loop
x, y = 0, 0 # x and y coordinates
p, q = 5, 1 7 # mathematical names in the context of the question
一般來說 i , j , k是循環(huán)中最常用的原朝。
Bad
o = O + 4 # letter ' O' or number 0?
l = l + 5 # letter ' l' or number 1 ?
用 o 和 l 很容易使 o 和 0 驯嘱，l 和1搞混
不必要的變量
Good
return answer(argument)
Bad
result = answer(argument)
return result
如果是表達式太長，或者返回的這個結果不是清晰明了的應該
創(chuàng)建一個變量竿拆。
Good
divisible_49 = lambda x: x % 49 == 0
score = (total + 1 ) // 7
do_something(divisible_49, score)
Bad
do_something(lambda x: x % 49 == 0, (total + 1 ) // 7)
命名約定
Good
total_score = 0
final_score = 1
def mean_strategy(score, opp):
class ExampleClass:
Bad
TotalScore = 0
finalScore = 1
def Mean_Strategy(score, opp):
class example_class:
# python 中一般變量和函數(shù)名使用下劃線宙拉，類名使用駝峰
使用空格代替tab，一般使用四個空格鍵丙笋。保存一行代碼不要過長谢澈，
大概在 70 個字符作用就好。
操作符之間的間隔
Good
x = a + b*c*(a**2) / c - 4
tup = (x, x/2, x/3, x/4)
Bad
x=a+b*c*(a**2)/c-4
tup = (x, x/2, x/3, x/4)
Good
def func(a, b, c, d, e, f,
g, h, i):
# body
tup = (1 , 2, 3, 4, 5,
6, 7, 8)
names = (' alice' ,
' bob' ,
' eve' )
控制語句
Bad
if pred == True: # bad!
. . .
if pred == False: # bad!
Good
if pred: # good!
. . .
if not pred: # good!
python 中的 [] , () , {} , set() 都可以使用bool判斷
if lst: # if lst is not empty
. . .
if not tup: # if tup is empty
這里要注意的一點是如果要將一個元素默認為一個list御板，
這種做法會使得每次調用都增加一個元素在x中锥忿。
def demo(x=[]):
pass
正確的做法是
def demo(x=None):
if x is None:
x = []
這里也不可以使用 not x，因為可能傳入的是一個空字符怠肋，
這種程序就會報錯敬鬓。
多余的if else
Bad
if pred: # bad!
return True
else:
return False
if num ! = 49:
total += example(4, 5, True)
else:
total += example(4, 5, False)
if pred: # bad!
print(' stuff' )
x += 1
return x
else:
x += 1
return x
Good
return pred
total += example(4, 5, num!=49)
if pred: # good!
print(' stuff' )
x += 1
return x
Good
把注釋寫到doc中，使用help函數(shù)可以看到
def average(fn, samples):
" " " Calls a 0-argument function SAMPLES times, and takes
the average of the outcome.
" " "
不必要的注釋
Bad
def example(y):
x += 1 # increments x by 1
return square(x) # returns the square of x
重復笙各，使用一個變量保存钉答。
Bad
if a + b - 3 * h / 2 % 47 == 4:
total += a + b - 3 * h / 2 % 47
return total
Good
turn_score = a + b - 3 * h / 2 % 47
if turn_score == 4:
total += turn_score
return total
合理使用 生成式
Good
ex = [x*x for x in range(1 0)]
L = [pair[0] + pair[1 ]
for pair in pairs
if len(pair) == 2]
Bad
L = [x + y + z for x in nums if x > 1 0 for y in nums2 for z in nums3 if y > z]
