基于Google的Python編碼規(guī)范標(biāo)準(zhǔn)
Python 風(fēng)格規(guī)范(Google)
本項(xiàng)目并非 Google 官方項(xiàng)目, 而是由國(guó)內(nèi)程序員憑熱情創(chuàng)建和維護(hù)。
如果你關(guān)注的是 Google 官方英文版, 請(qǐng)移步 Google Style Guide
以下代碼中 Yes 表示推薦，No 表示不推薦。
分號(hào)
不要在行尾加分號(hào), 也不要用分號(hào)將兩條命令放在同一行。
行長(zhǎng)度
每行不超過(guò)80個(gè)字符
以下情況除外：
- 長(zhǎng)的導(dǎo)入模塊語(yǔ)句注釋里的URL
- 不要使用反斜杠連接行。
Python會(huì)將 圓括號(hào), 中括號(hào)和花括號(hào)中的行隱式的連接起來(lái) , 你可以利用這個(gè)特點(diǎn).
如果需要, 你可以在表達(dá)式外圍增加一對(duì)額外的圓括號(hào)。
推薦: foo_bar(self, width, height, color='black', design=None, x='foo',
emphasis=None, highlight=0)
if (width == 0 and height == 0 and
color == 'red' and emphasis == 'strong'):
如果一個(gè)文本字符串在一行放不下, 可以使用圓括號(hào)來(lái)實(shí)現(xiàn)隱式行連接:
x = ('這是一個(gè)非常長(zhǎng)非常長(zhǎng)非常長(zhǎng)非常長(zhǎng) '
'非常長(zhǎng)非常長(zhǎng)非常長(zhǎng)非常長(zhǎng)非常長(zhǎng)非常長(zhǎng)的字符串')
在注釋中，如果必要，將長(zhǎng)的URL放在一行上。
Yes: # See details at
# http://www.example.com/us/developer/documentation/api/content/v2.0/csv_file_name_extension_full_specification.html
No: # See details at
# http://www.example.com/us/developer/documentation/api/content/\
# v2.0/csv_file_name_extension_full_specification.html
注意上面例子中的元素縮進(jìn); 你可以在本文的 :ref:`縮進(jìn) <indentation>`部分找到解釋.
括號(hào)
寧缺毋濫的使用括號(hào)
除非是用于實(shí)現(xiàn)行連接, 否則不要在返回語(yǔ)句或條件語(yǔ)句中使用括號(hào).
不過(guò)在元組兩邊使用括號(hào)是可以的.
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)
縮進(jìn)
用4個(gè)空格來(lái)縮進(jìn)代碼
絕對(duì)不要用tab, 也不要tab和空格混用.
對(duì)于行連接的情況, 你應(yīng)該要么垂直對(duì)齊換行的元素(見(jiàn) :ref:`行長(zhǎng)度 <line_length>` 部分的示例),
或者使用4空格的懸掛式縮進(jìn)(這時(shí)第一行不應(yīng)該有參數(shù)):
Yes: # 與起始變量對(duì)齊
foo = long_function_name(var_one, var_two,
var_three, var_four)
# 字典中與起始值對(duì)齊
foo = {
long_dictionary_key: value1 +
value2,
...
}
# 4 個(gè)空格縮進(jìn)，第一行不需要
foo = long_function_name(
var_one, var_two, var_three,
var_four)
# 字典中 4 個(gè)空格縮進(jìn)
foo = {
long_dictionary_key:
long_dictionary_value,
...
}
No: # 第一行有空格是禁止的
foo = long_function_name(var_one, var_two,
var_three, var_four)
# 2 個(gè)空格是禁止的
foo = long_function_name(
var_one, var_two, var_three,
var_four)
# 字典中沒(méi)有處理縮進(jìn)
foo = {
long_dictionary_key:
long_dictionary_value,
...
}
空行
頂級(jí)定義之間空兩行, 方法定義之間空一行
頂級(jí)定義之間空兩行, 比如函數(shù)或者類(lèi)定義. 方法定義, 類(lèi)定義與第一個(gè)方法之間, 都應(yīng)該空一行.
函數(shù)或方法中, 某些地方要是你覺(jué)得合適, 就空一行.
空格
按照標(biāo)準(zhǔn)的排版規(guī)范來(lái)使用標(biāo)點(diǎn)兩邊的空格
括號(hào)內(nèi)不要有空格.
按照標(biāo)準(zhǔn)的排版規(guī)范來(lái)使用標(biāo)點(diǎn)兩邊的空格
Yes: spam(ham[1], {eggs: 2}, [])
No: spam( ham[ 1 ], { eggs: 2 }, [ ] )
不要在逗號(hào), 分號(hào), 冒號(hào)前面加空格, 但應(yīng)該在它們后面加(除了在行尾).
Yes: if x == 4:
print x, y
x, y = y, x
No: if x == 4 :
print x , y
x , y = y , x
參數(shù)列表, 索引或切片的左括號(hào)前不應(yīng)加空格.
Yes: spam(1)
no: spam (1)
Yes: dict['key'] = list[index]
Yes: dict['key'] = list[index]
在二元操作符兩邊都加上一個(gè)空格,
比如賦值(=), 比較(==, <, >, !=, <>, <=, >=, in, not in, is, is not), 布爾(and, or, not).
至于算術(shù)操作符兩邊的空格該如何使用, 需要你自己好好判斷. 不
過(guò)兩側(cè)務(wù)必要保持一致.
Yes: x == 1
No: x<1
當(dāng)'='用于指示關(guān)鍵字參數(shù)或默認(rèn)參數(shù)值時(shí), 不要在其兩側(cè)使用空格.
Yes: def complex(real, imag=0.0): return magic(r=real, i=imag)
No: def complex(real, imag = 0.0): return magic(r = real, i = imag)
不要用空格來(lái)垂直對(duì)齊多行間的標(biāo)記, 因?yàn)檫@會(huì)成為維護(hù)的負(fù)擔(dān)(適用于:, #, =等):
Yes:
foo = 1000 # 注釋
long_name = 2 # 注釋不需要對(duì)齊
dictionary = {
"foo": 1,
"long_name": 2,
}
No:
foo = 1000 # 注釋
long_name = 2 # 注釋不需要對(duì)齊
dictionary = {
"foo" : 1,
"long_name": 2,
}
以上就是基于Google的Python編碼規(guī)范標(biāo)準(zhǔn)的詳細(xì)內(nèi)容，更多關(guān)于Google的Python編碼規(guī)范的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
pytorch如何使用訓(xùn)練好的模型預(yù)測(cè)新數(shù)據(jù)
這篇文章主要介紹了pytorch如何使用訓(xùn)練好的模型預(yù)測(cè)新數(shù)據(jù)問(wèn)題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2023-06-06
pandas學(xué)習(xí)之txt與sql文件的基本操作指南
Pandas是Python的第三方庫(kù),提供高性能易用的數(shù)據(jù)類(lèi)型和分析工具,下面這篇文章主要給大家介紹了關(guān)于pandas學(xué)習(xí)之txt與sql文件的基本操作指南,需要的朋友可以參考下2021-08-08
使用Python實(shí)現(xiàn)為PDF文檔設(shè)置背景色或背景圖
PDF作為一種跨平臺(tái)、高保真的文件格式被廣泛應(yīng)用,這篇文章主要為大家詳細(xì)介紹了如何使用Python代碼對(duì)PDF文檔進(jìn)行頁(yè)面背景色或背景圖片的設(shè)置,需要的可以參考下2024-04-04
Pycharm中pyqt工具配置(Qt Designer、PyUIC、PyRCC)
Pycharm中進(jìn)行擴(kuò)展工具設(shè)置，從而實(shí)現(xiàn)在pycharm中打開(kāi)Qt Designer、Ui文件生成Py文件、資源文件生成Py文件三個(gè)功能，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2023-07-07
Python對(duì)列表的操作知識(shí)點(diǎn)詳解
在本篇文章里小編給大家整理了關(guān)于Python對(duì)列表的操作知識(shí)點(diǎn)總結(jié)以及實(shí)例代碼運(yùn)用，需要的朋友們跟著學(xué)習(xí)下。2019-08-08
python中將函數(shù)賦值給變量時(shí)需要注意的一些問(wèn)題
變量賦值是我們?cè)谌粘ｉ_(kāi)發(fā)中經(jīng)常會(huì)遇到的一個(gè)問(wèn)題，下面這篇文章主要給大家介紹了關(guān)于python中將函數(shù)賦值給變量時(shí)需要注意的一些問(wèn)題，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來(lái)一起看看吧。2017-08-08
Python&&GDAL實(shí)現(xiàn)NDVI的計(jì)算方式
今天小編就為大家分享一篇Python&&GDAL實(shí)現(xiàn)NDVI的計(jì)算方式，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-01-01
這一講中的list類(lèi)型，也是python的一種數(shù)據(jù)類(lèi)型。翻譯為：列表。LIST在python中具有非常強(qiáng)大的功能。2014-09-09
這篇文章主要介紹了python-opencv如何讀取圖片及尺寸修改，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2022-11-11
今天小編就為大家分享一篇python獲取array中指定元素的示例，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2019-11-11