在线观看www成人影院-在线观看www日本免费网站-在线观看www视频-在线观看操-欧美18在线-欧美1级

0
  • 聊天消息
  • 系統(tǒng)消息
  • 評(píng)論與回復(fù)
登錄后你可以
  • 下載海量資料
  • 學(xué)習(xí)在線課程
  • 觀看技術(shù)視頻
  • 寫(xiě)文章/發(fā)帖/加入社區(qū)
會(huì)員中心
創(chuàng)作中心

完善資料讓更多小伙伴認(rèn)識(shí)你,還能領(lǐng)取20積分哦,立即完善>

3天內(nèi)不再提示

Python編寫(xiě)代碼的風(fēng)格規(guī)范是怎樣的

jmiy_worldofai ? 來(lái)源:未知 ? 作者:易水寒 ? 2018-11-11 09:21 ? 次閱讀

分號(hào)

Tip

不要在行尾加分號(hào), 也不要用分號(hào)將兩條命令放在同一行.

行長(zhǎng)度

Tip

每行不超過(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).

Yes:foo_bar(self,width,height,color='black',design=None,x='foo',emphasis=None,highlight=0)if(width==0andheight==0andcolor=='red'andemphasis=='strong'):

如果一個(gè)文本字符串在一行放不下, 可以使用圓括號(hào)來(lái)實(shí)現(xiàn)隱式行連接:

x=('Thiswillbuildaverylonglong''longlonglonglonglonglongstring')

在注釋中,如果必要,將長(zhǎng)的URL放在一行上。

Yes:#Seedetailsat#http://www.example.com/us/developer/documentation/api/content/v2.0/csv_file_name_extension_full_specification.htmlNo:#Seedetailsat#http://www.example.com/us/developer/documentation/api/content/#v2.0/csv_file_name_extension_full_specification.html

注意上面例子中的元素縮進(jìn); 你可以在本文的縮進(jìn)部分找到解釋.

括號(hào)

Tip

寧缺毋濫的使用括號(hào)

除非是用于實(shí)現(xiàn)行連接, 否則不要在返回語(yǔ)句或條件語(yǔ)句中使用括號(hào). 不過(guò)在元組兩邊使用括號(hào)是可以的.

Yes:iffoo:bar()whilex:x=bar()ifxandy:bar()ifnotx:bar()returnfoofor(x,y)indict.items():...No:if(x):bar()ifnot(x):bar()return(foo)

縮進(jìn)

Tip

用4個(gè)空格來(lái)縮進(jìn)代碼

絕對(duì)不要用tab, 也不要tab和空格混用. 對(duì)于行連接的情況, 你應(yīng)該要么垂直對(duì)齊換行的元素(見(jiàn)行長(zhǎng)度部分的示例), 或者使用4空格的懸掛式縮進(jìn)(這時(shí)第一行不應(yīng)該有參數(shù)):

Yes:#Alignedwithopeningdelimiterfoo=long_function_name(var_one,var_two,var_three,var_four)#Alignedwithopeningdelimiterinadictionaryfoo={long_dictionary_key:value1+value2,...}#4-spacehangingindent;nothingonfirstlinefoo=long_function_name(var_one,var_two,var_three,var_four)#4-spacehangingindentinadictionaryfoo={long_dictionary_key:long_dictionary_value,...}No:#Stuffonfirstlineforbiddenfoo=long_function_name(var_one,var_two,var_three,var_four)#2-spacehangingindentforbiddenfoo=long_function_name(var_one,var_two,var_three,var_four)#Nohangingindentinadictionaryfoo={long_dictionary_key:long_dictionary_value,...}

空行

Tip

頂級(jí)定義之間空兩行, 方法定義之間空一行

頂級(jí)定義之間空兩行, 比如函數(shù)或者類定義. 方法定義, 類定義與第一個(gè)方法之間, 都應(yīng)該空一行. 函數(shù)或方法中, 某些地方要是你覺(jué)得合適, 就空一行.

空格

Tip

按照標(biāo)準(zhǔn)的排版規(guī)范來(lái)使用標(biāo)點(diǎn)兩邊的空格

括號(hào)內(nèi)不要有空格.

Yes:spam(ham[1],{eggs:2},[])No:spam(ham[1],{eggs:2},[])

不要在逗號(hào), 分號(hào), 冒號(hào)前面加空格, 但應(yīng)該在它們后面加(除了在行尾).

Yes:ifx==4:printx,yx,y=y,xNo:ifx==4:printx,yx,y=y,x

參數(shù)列表, 索引或切片的左括號(hào)前不應(yīng)加空格.

Yes:spam(1)no:spam(1)Yes:dict['key']=list[index]No:dict['key']=list[index]

在二元操作符兩邊都加上一個(gè)空格, 比如賦值(=), 比較(==, <, >, !=, <>, <=, >=, in, not in, is, is not), 布爾(and, or, not). 至于算術(shù)操作符兩邊的空格該如何使用, 需要你自己好好判斷. 不過(guò)兩側(cè)務(wù)必要保持一致.

Yes:x==1No:x<1

當(dāng)’=’用于指示關(guān)鍵字參數(shù)或默認(rèn)參數(shù)值時(shí), 不要在其兩側(cè)使用空格.

Yes:defcomplex(real,imag=0.0):returnmagic(r=real,i=imag)No:defcomplex(real,imag=0.0):returnmagic(r=real,i=imag)

不要用空格來(lái)垂直對(duì)齊多行間的標(biāo)記, 因?yàn)檫@會(huì)成為維護(hù)的負(fù)擔(dān)(適用于:, #, =等):

Yes:foo=1000#commentlong_name=2#commentthatshouldnotbealigneddictionary={"foo":1,"long_name":2,}No:foo=1000#commentlong_name=2#commentthatshouldnotbealigneddictionary={"foo":1,"long_name":2,}

Shebang

Tip

大部分.py文件不必以#!作為文件的開(kāi)始. 根據(jù)PEP-394, 程序的main文件應(yīng)該以 #!/usr/bin/python2或者 #!/usr/bin/python3開(kāi)始.

(譯者注: 在計(jì)算機(jī)科學(xué)中,Shebang(也稱為Hashbang)是一個(gè)由井號(hào)和嘆號(hào)構(gòu)成的字符串行(#!), 其出現(xiàn)在文本文件的第一行的前兩個(gè)字符. 在文件中存在Shebang的情況下, 類Unix操作系統(tǒng)的程序載入器會(huì)分析Shebang后的內(nèi)容, 將這些內(nèi)容作為解釋器指令, 并調(diào)用該指令, 并將載有Shebang的文件路徑作為該解釋器的參數(shù). 例如, 以指令#!/bin/sh開(kāi)頭的文件在執(zhí)行時(shí)會(huì)實(shí)際調(diào)用/bin/sh程序.)

#!先用于幫助內(nèi)核找到Python解釋器, 但是在導(dǎo)入模塊時(shí), 將會(huì)被忽略. 因此只有被直接執(zhí)行的文件中才有必要加入#!.

注釋

Tip

確保對(duì)模塊, 函數(shù), 方法和行內(nèi)注釋使用正確的風(fēng)格

文檔字符串

Python有一種獨(dú)一無(wú)二的的注釋方式: 使用文檔字符串. 文檔字符串是包, 模塊, 類或函數(shù)里的第一個(gè)語(yǔ)句. 這些字符串可以通過(guò)對(duì)象的__doc__成員被自動(dòng)提取, 并且被pydoc所用. (你可以在你的模塊上運(yùn)行pydoc試一把, 看看它長(zhǎng)什么樣). 我們對(duì)文檔字符串的慣例是使用三重雙引號(hào)”“”(PEP-257). 一個(gè)文檔字符串應(yīng)該這樣組織: 首先是一行以句號(hào), 問(wèn)號(hào)或驚嘆號(hào)結(jié)尾的概述(或者該文檔字符串單純只有一行). 接著是一個(gè)空行. 接著是文檔字符串剩下的部分, 它應(yīng)該與文檔字符串的第一行的第一個(gè)引號(hào)對(duì)齊. 下面有更多文檔字符串的格式化規(guī)范.

模塊

每個(gè)文件應(yīng)該包含一個(gè)許可樣板. 根據(jù)項(xiàng)目使用的許可(例如, Apache 2.0, BSD, LGPL, GPL), 選擇合適的樣板.

函數(shù)和方法

下文所指的函數(shù),包括函數(shù), 方法, 以及生成器.

一個(gè)函數(shù)必須要有文檔字符串, 除非它滿足以下條件:

外部不可見(jiàn)

非常短小

簡(jiǎn)單明了

文檔字符串應(yīng)該包含函數(shù)做什么, 以及輸入和輸出的詳細(xì)描述. 通常, 不應(yīng)該描述”怎么做”, 除非是一些復(fù)雜的算法. 文檔字符串應(yīng)該提供足夠的信息, 當(dāng)別人編寫(xiě)代碼調(diào)用該函數(shù)時(shí), 他不需要看一行代碼, 只要看文檔字符串就可以了. 對(duì)于復(fù)雜的代碼, 在代碼旁邊加注釋會(huì)比使用文檔字符串更有意義.

關(guān)于函數(shù)的幾個(gè)方面應(yīng)該在特定的小節(jié)中進(jìn)行描述記錄, 這幾個(gè)方面如下文所述. 每節(jié)應(yīng)該以一個(gè)標(biāo)題行開(kāi)始. 標(biāo)題行以冒號(hào)結(jié)尾. 除標(biāo)題行外, 節(jié)的其他內(nèi)容應(yīng)被縮進(jìn)2個(gè)空格.

Args:

列出每個(gè)參數(shù)的名字, 并在名字后使用一個(gè)冒號(hào)和一個(gè)空格, 分隔對(duì)該參數(shù)的描述.如果描述太長(zhǎng)超過(guò)了單行80字符,使用2或者4個(gè)空格的懸掛縮進(jìn)(與文件其他部分保持一致). 描述應(yīng)該包括所需的類型和含義. 如果一個(gè)函數(shù)接受*foo(可變長(zhǎng)度參數(shù)列表)或者**bar (任意關(guān)鍵字參數(shù)), 應(yīng)該詳細(xì)列出*foo和**bar.

Returns: (或者 Yields: 用于生成器)

描述返回值的類型和語(yǔ)義. 如果函數(shù)返回None, 這一部分可以省略.

Raises:

列出與接口有關(guān)的所有異常.

deffetch_bigtable_rows(big_table,keys,other_silly_variable=None):"""FetchesrowsfromaBigtable.RetrievesrowspertainingtothegivenkeysfromtheTableinstancerepresentedbybig_table.Sillythingsmayhappenifother_silly_variableisnotNone.Args:big_table:AnopenBigtableTableinstance.keys:Asequenceofstringsrepresentingthekeyofeachtablerowtofetch.other_silly_variable:Anotheroptionalvariable,thathasamuchlongernamethantheotherargs,andwhichdoesnothing.Returns:Adictmappingkeystothecorrespondingtablerowdatafetched.Eachrowisrepresentedasatupleofstrings.Forexample:{'Serak':('RigelVII','Preparer'),'Zim':('Irk','Invader'),'Lrrr':('OmicronPersei8','Emperor')}Ifakeyfromthekeysargumentismissingfromthedictionary,thenthatrowwasnotfoundinthetable.Raises:IOError:Anerroroccurredaccessingthebigtable.Tableobject."""pass

類應(yīng)該在其定義下有一個(gè)用于描述該類的文檔字符串. 如果你的類有公共屬性(Attributes), 那么文檔中應(yīng)該有一個(gè)屬性(Attributes)段. 并且應(yīng)該遵守和函數(shù)參數(shù)相同的格式.

classSampleClass(object):"""Summaryofclasshere.Longerclassinformation....Longerclassinformation....Attributes:likes_spam:AbooleanindicatingifwelikeSPAMornot.eggs:Anintegercountoftheeggswehavelaid."""def__init__(self,likes_spam=False):"""InitsSampleClasswithblah."""self.likes_spam=likes_spamself.eggs=0defpublic_method(self):"""Performsoperationblah."""

塊注釋和行注釋

最需要寫(xiě)注釋的是代碼中那些技巧性的部分. 如果你在下次代碼審查的時(shí)候必須解釋一下, 那么你應(yīng)該現(xiàn)在就給它寫(xiě)注釋. 對(duì)于復(fù)雜的操作, 應(yīng)該在其操作開(kāi)始前寫(xiě)上若干行注釋. 對(duì)于不是一目了然的代碼, 應(yīng)在其行尾添加注釋.

#Weuseaweighteddictionarysearchtofindoutwhereiisin#thearray.Weextrapolatepositionbasedonthelargestnum#inthearrayandthearraysizeandthendobinarysearchto#gettheexactnumber.ifi&(i-1)==0:#trueiffiisapowerof2

為了提高可讀性, 注釋?xiě)?yīng)該至少離開(kāi)代碼2個(gè)空格.

另一方面, 絕不要描述代碼. 假設(shè)閱讀代碼的人比你更懂Python, 他只是不知道你的代碼要做什么.

#BADCOMMENT:Nowgothroughthebarrayandmakesurewheneverioccurs#thenextelementisi+1

Tip

如果一個(gè)類不繼承自其它類, 就顯式的從object繼承. 嵌套類也一樣.

Yes:classSampleClass(object):passclassOuterClass(object):classInnerClass(object):passclassChildClass(ParentClass):"""Explicitlyinheritsfromanotherclassalready."""No:classSampleClass:passclassOuterClass:classInnerClass:pass

繼承自object是為了使屬性(properties)正常工作, 并且這樣可以保護(hù)你的代碼, 使其不受PEP-3000的一個(gè)特殊的潛在不兼容性影響. 這樣做也定義了一些特殊的方法, 這些方法實(shí)現(xiàn)了對(duì)象的默認(rèn)語(yǔ)義, 包括

__new__,__init__,__delattr__,__getattribute__,__setattr__,__hash__,__repr__,and__str__.

字符串

Tip

即使參數(shù)都是字符串, 使用%操作符或者格式化方法格式化字符串. 不過(guò)也不能一概而論, 你需要在+和%之間好好判定.

Yes:x=a+bx='%s,%s!'%(imperative,expletive)x='{},{}!'.format(imperative,expletive)x='name:%s;score:%d'%(name,n)x='name:{};score:{}'.format(name,n)No:x='%s%s'%(a,b)#use+inthiscasex='{}{}'.format(a,b)#use+inthiscasex=imperative+','+expletive+'!'x='name:'+name+';score:'+str(n)

避免在循環(huán)中用+和+=操作符來(lái)累加字符串. 由于字符串是不可變的, 這樣做會(huì)創(chuàng)建不必要的臨時(shí)對(duì)象, 并且導(dǎo)致二次方而不是線性的運(yùn)行時(shí)間. 作為替代方案, 你可以將每個(gè)子串加入列表, 然后在循環(huán)結(jié)束后用.join連接列表. (也可以將每個(gè)子串寫(xiě)入一個(gè)cStringIO.StringIO緩存中.)

Yes:items=['

']forlast_name,first_nameinemployee_list:items.append(''%(last_name,first_name))items.append('
%s,%s
')employee_table=''.join(items)No:employee_table=''forlast_name,first_nameinemployee_list:employee_table+=''%(last_name,first_name)employee_table+='
%s,%s
'

在同一個(gè)文件中, 保持使用字符串引號(hào)的一致性. 使用單引號(hào)’或者雙引號(hào)”之一用以引用字符串, 并在同一文件中沿用. 在字符串內(nèi)可以使用另外一種引號(hào), 以避免在字符串中使用. GPyLint已經(jīng)加入了這一檢查.

(譯者注:GPyLint疑為筆誤, 應(yīng)為PyLint.)

Yes:Python('Whyareyouhidingyoureyes?')Gollum("I'mscaredoflinterrors.")Narrator('"Good!"thoughtahappyPythonreviewer.')No:Python("Whyareyouhidingyoureyes?")Gollum('Thelint.Itburns.Itburnsus.')Gollum("Alwaysthegreatlint.Watching.Watching.")

為多行字符串使用三重雙引號(hào)”“”而非三重單引號(hào)’‘’. 當(dāng)且僅當(dāng)項(xiàng)目中使用單引號(hào)’來(lái)引用字符串時(shí), 才可能會(huì)使用三重’‘’為非文檔字符串的多行字符串來(lái)標(biāo)識(shí)引用. 文檔字符串必須使用三重雙引號(hào)”“”. 不過(guò)要注意, 通常用隱式行連接更清晰, 因?yàn)槎嘈凶址c程序其他部分的縮進(jìn)方式不一致.

Yes:print("Thisismuchnicer. ""Doitthisway. ")No:print"""Thisisprettyugly.Don'tdothis."""

文件和sockets

Tip

在文件和sockets結(jié)束時(shí), 顯式的關(guān)閉它.

除文件外, sockets或其他類似文件的對(duì)象在沒(méi)有必要的情況下打開(kāi), 會(huì)有許多副作用, 例如:

它們可能會(huì)消耗有限的系統(tǒng)資源, 如文件描述符. 如果這些資源在使用后沒(méi)有及時(shí)歸還系統(tǒng), 那么用于處理這些對(duì)象的代碼會(huì)將資源消耗殆盡.

持有文件將會(huì)阻止對(duì)于文件的其他諸如移動(dòng)、刪除之類的操作.

僅僅是從邏輯上關(guān)閉文件和sockets, 那么它們?nèi)匀豢赡軙?huì)被其共享的程序在無(wú)意中進(jìn)行讀或者寫(xiě)操作. 只有當(dāng)它們真正被關(guān)閉后, 對(duì)于它們嘗試進(jìn)行讀或者寫(xiě)操作將會(huì)拋出異常, 并使得問(wèn)題快速顯現(xiàn)出來(lái).

而且, 幻想當(dāng)文件對(duì)象析構(gòu)時(shí), 文件和sockets會(huì)自動(dòng)關(guān)閉, 試圖將文件對(duì)象的生命周期和文件的狀態(tài)綁定在一起的想法, 都是不現(xiàn)實(shí)的. 因?yàn)橛腥缦略?

沒(méi)有任何方法可以確保運(yùn)行環(huán)境會(huì)真正的執(zhí)行文件的析構(gòu). 不同的Python實(shí)現(xiàn)采用不同的內(nèi)存管理技術(shù), 比如延時(shí)垃圾處理機(jī)制. 延時(shí)垃圾處理機(jī)制可能會(huì)導(dǎo)致對(duì)象生命周期被任意無(wú)限制的延長(zhǎng).

對(duì)于文件意外的引用,會(huì)導(dǎo)致對(duì)于文件的持有時(shí)間超出預(yù)期(比如對(duì)于異常的跟蹤, 包含有全局變量等).

推薦使用“with”語(yǔ)句以管理文件:

withopen("hello.txt")ashello_file:forlineinhello_file:printline

對(duì)于不支持使用”with”語(yǔ)句的類似文件的對(duì)象,使用 contextlib.closing():

importcontextlibwithcontextlib.closing(urllib.urlopen("http://www.python.org/"))asfront_page:forlineinfront_page:printline

Legacy AppEngine 中Python 2.5的代碼如使用”with”語(yǔ)句, 需要添加 “from __future__ import with_statement”.

TODO注釋

Tip

為臨時(shí)代碼使用TODO注釋, 它是一種短期解決方案. 不算完美, 但夠好了.

TODO注釋?xiě)?yīng)該在所有開(kāi)頭處包含”TODO”字符串, 緊跟著是用括號(hào)括起來(lái)的你的名字, email地址或其它標(biāo)識(shí)符. 然后是一個(gè)可選的冒號(hào). 接著必須有一行注釋, 解釋要做什么. 主要目的是為了有一個(gè)統(tǒng)一的TODO格式, 這樣添加注釋的人就可以搜索到(并可以按需提供更多細(xì)節(jié)). 寫(xiě)了TODO注釋并不保證寫(xiě)的人會(huì)親自解決問(wèn)題. 當(dāng)你寫(xiě)了一個(gè)TODO, 請(qǐng)注上你的名字.

#TODO(kl@gmail.com):Usea"*"hereforstringrepetition.#TODO(Zeke)Changethistouserelations.

如果你的TODO是”將來(lái)做某事”的形式, 那么請(qǐng)確保你包含了一個(gè)指定的日期(“2009年11月解決”)或者一個(gè)特定的事件(“等到所有的客戶都可以處理XML請(qǐng)求就移除這些代碼”).

導(dǎo)入格式

Tip

每個(gè)導(dǎo)入應(yīng)該獨(dú)占一行

Yes:importosimportsysNo:importos,sys

導(dǎo)入總應(yīng)該放在文件頂部, 位于模塊注釋和文檔字符串之后, 模塊全局變量和常量之前. 導(dǎo)入應(yīng)該按照從最通用到最不通用的順序分組:

標(biāo)準(zhǔn)庫(kù)導(dǎo)入

第三方庫(kù)導(dǎo)入

應(yīng)用程序指定導(dǎo)入

每種分組中, 應(yīng)該根據(jù)每個(gè)模塊的完整包路徑按字典序排序, 忽略大小寫(xiě).

importfoofromfooimportbarfromfoo.barimportba***romfoo.barimportQuuxfromFoobimportar

語(yǔ)句

Tip

通常每個(gè)語(yǔ)句應(yīng)該獨(dú)占一行

不過(guò), 如果測(cè)試結(jié)果與測(cè)試語(yǔ)句在一行放得下, 你也可以將它們放在同一行. 如果是if語(yǔ)句, 只有在沒(méi)有else時(shí)才能這樣做. 特別地, 絕不要對(duì)try/except這樣做, 因?yàn)閠ry和except不能放在同一行.

Yes:iffoo:bar(foo)No:iffoo:bar(foo)else:baz(foo)try:bar(foo)exceptValueError:baz(foo)try:bar(foo)exceptValueError:baz(foo)

訪問(wèn)控制

Tip

在Python中, 對(duì)于瑣碎又不太重要的訪問(wèn)函數(shù), 你應(yīng)該直接使用公有變量來(lái)取代它們, 這樣可以避免額外的函數(shù)調(diào)用開(kāi)銷. 當(dāng)添加更多功能時(shí), 你可以用屬性(property)來(lái)保持語(yǔ)法的一致性.

(譯者注: 重視封裝的面向?qū)ο?a href="http://www.xsypw.cn/v/tag/1730/" target="_blank">程序員看到這個(gè)可能會(huì)很反感, 因?yàn)樗麄円恢北唤逃? 所有成員變量都必須是私有的! 其實(shí), 那真的是有點(diǎn)麻煩啊. 試著去接受Pythonic哲學(xué)吧)

另一方面, 如果訪問(wèn)更復(fù)雜, 或者變量的訪問(wèn)開(kāi)銷很顯著, 那么你應(yīng)該使用像get_foo()和set_foo()這樣的函數(shù)調(diào)用. 如果之前的代碼行為允許通過(guò)屬性(property)訪問(wèn) , 那么就不要將新的訪問(wèn)函數(shù)與屬性綁定. 這樣, 任何試圖通過(guò)老方法訪問(wèn)變量的代碼就沒(méi)法運(yùn)行, 使用者也就會(huì)意識(shí)到復(fù)雜性發(fā)生了變化.

命名

Tip

module_name, package_name, ClassName, method_name, ExceptionName,

function_name, GLOBAL_VAR_NAME, instance_var_name, function_parameter_name,local_var_name.

應(yīng)該避免的名稱

單字符名稱, 除了計(jì)數(shù)器和迭代器.

包/模塊名中的連字符(-)

雙下劃線開(kāi)頭并結(jié)尾的名稱(Python保留, 例如__init__)

命名約定

所謂”內(nèi)部(Internal)”表示僅模塊內(nèi)可用, 或者, 在類內(nèi)是保護(hù)或私有的.

用單下劃線(_)開(kāi)頭表示模塊變量或函數(shù)是protected的(使用import * from時(shí)不會(huì)包含).

用雙下劃線(__)開(kāi)頭的實(shí)例變量或方法表示類內(nèi)私有.

將相關(guān)的類和頂級(jí)函數(shù)放在同一個(gè)模塊里. 不像Java, 沒(méi)必要限制一個(gè)類一個(gè)模塊.

對(duì)類名使用大寫(xiě)字母開(kāi)頭的單詞(如CapWords, 即Pascal風(fēng)格), 但是模塊名應(yīng)該用小寫(xiě)加下劃線的方式(如lower_with_under.py). 盡管已經(jīng)有很多現(xiàn)存的模塊使用類似于CapWords.py這樣的命名, 但現(xiàn)在已經(jīng)不鼓勵(lì)這樣做, 因?yàn)槿绻K名碰巧和類名一致, 這會(huì)讓人困擾.

Python之父Guido推薦的規(guī)范

Main

Tip

即使是一個(gè)打算被用作腳本的文件, 也應(yīng)該是可導(dǎo)入的. 并且簡(jiǎn)單的導(dǎo)入不應(yīng)該導(dǎo)致這個(gè)腳本的主功能(main functionality)被執(zhí)行, 這是一種副作用. 主功能應(yīng)該放在一個(gè)main()函數(shù)中.

在Python中, pydoc以及單元測(cè)試要求模塊必須是可導(dǎo)入的. 你的代碼應(yīng)該在執(zhí)行主程序前總是檢查if__name__=='__main__', 這樣當(dāng)模塊被導(dǎo)入時(shí)主程序就不會(huì)被執(zhí)行.

defmain():...if__name__=='__main__':main()

所有的頂級(jí)代碼在模塊導(dǎo)入時(shí)都會(huì)被執(zhí)行. 要小心不要去調(diào)用函數(shù), 創(chuàng)建對(duì)象, 或者執(zhí)行那些不應(yīng)該在使用pydoc時(shí)執(zhí)行的操作.

聲明:本文內(nèi)容及配圖由入駐作者撰寫(xiě)或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人,不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用,如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題,請(qǐng)聯(lián)系本站處理。 舉報(bào)投訴
  • URL
    URL
    +關(guān)注

    關(guān)注

    0

    文章

    139

    瀏覽量

    15370
  • 代碼
    +關(guān)注

    關(guān)注

    30

    文章

    4798

    瀏覽量

    68728
  • python
    +關(guān)注

    關(guān)注

    56

    文章

    4798

    瀏覽量

    84800

原文標(biāo)題:Python風(fēng)格規(guī)范

文章出處:【微信號(hào):worldofai,微信公眾號(hào):worldofai】歡迎添加關(guān)注!文章轉(zhuǎn)載請(qǐng)注明出處。

收藏 人收藏

    評(píng)論

    相關(guān)推薦

    FPGA實(shí)戰(zhàn)演練邏輯篇39:代碼風(fēng)格與書(shū)寫(xiě)規(guī)范

    這兩個(gè)概念有不同的理解,很多人也會(huì)認(rèn)為代碼風(fēng)格代碼書(shū)寫(xiě)規(guī)范說(shuō)的是一碼事。不管怎樣,筆者在此為了說(shuō)明和
    發(fā)表于 06-19 10:38

    怎樣在openmv上編寫(xiě)nrf24l01的發(fā)送代碼Python

    nrf24l01是如何完成通信的?怎樣在openmv上編寫(xiě)nrf24l01的發(fā)送代碼Python呢?
    發(fā)表于 12-17 06:54

    C語(yǔ)言代碼風(fēng)格有哪些

    C語(yǔ)言代碼的命名風(fēng)格怎樣的?C語(yǔ)言代碼的程序風(fēng)格怎樣的?
    發(fā)表于 02-25 07:21

    嵌入式代碼編寫(xiě)規(guī)范

    嵌入式代碼編碼規(guī)范,用于規(guī)范自己的代碼,增強(qiáng)可讀性,非標(biāo)準(zhǔn)規(guī)范。最好能強(qiáng)制自己形成良好的編碼風(fēng)格
    的頭像 發(fā)表于 04-26 15:21 ?5294次閱讀

    Python編寫(xiě)代碼規(guī)范要求

    在我們?nèi)粘I钪校鍪裁词虑橹v究規(guī)矩,當(dāng)然我們寫(xiě)程序也不例外,也是有規(guī)范的。遵循好的規(guī)范可以不僅提高我們代碼的可讀性,還可以提高程序開(kāi)發(fā)效率。
    發(fā)表于 01-16 17:44 ?1821次閱讀
    <b class='flag-5'>Python</b><b class='flag-5'>編寫(xiě)</b><b class='flag-5'>代碼</b>的<b class='flag-5'>規(guī)范</b>要求

    python3編寫(xiě)的人臉識(shí)別源代碼合集免費(fèi)下載

    本文檔的主要內(nèi)容詳細(xì)介紹的是python3編寫(xiě)的人臉識(shí)別源代碼合集免費(fèi)下載,有3個(gè)不同的代碼,分別是三種不同的算法。
    發(fā)表于 03-12 08:00 ?6次下載

    編寫(xiě)代碼習(xí)慣談工程師風(fēng)格

    引語(yǔ):代碼風(fēng)格,是一個(gè)工程師長(zhǎng)期以來(lái)養(yǎng)成的一些編寫(xiě)代碼的習(xí)慣,其實(shí)并無(wú)絕對(duì)的好壞之分!但是,基本上可以這么說(shuō),一個(gè)有很好的代碼
    的頭像 發(fā)表于 01-15 10:11 ?1615次閱讀

    Linux內(nèi)核的首選代碼風(fēng)格應(yīng)該如何設(shè)置

    遵守這個(gè)風(fēng)格。請(qǐng)?jiān)趯?xiě)代碼時(shí)至少考慮一下本文所述的風(fēng)格。首先,我建議你打印一份ONU代碼規(guī)范,然后不要讀它。燒了它,這是一個(gè)意義重大的象征性的
    發(fā)表于 11-04 17:17 ?6次下載
    Linux內(nèi)核的首選<b class='flag-5'>代碼</b><b class='flag-5'>風(fēng)格</b>應(yīng)該如何設(shè)置

    怎么樣才能讓Java代碼編寫(xiě)規(guī)范

    作者 | 濤姐濤哥 鏈接 | cnblogs.com/taojietaoge/p/11575376.html 如何更規(guī)范編寫(xiě)Java 代碼 Many of the happiest people
    的頭像 發(fā)表于 08-27 09:31 ?3691次閱讀

    如何使用Warp在Python環(huán)境中編寫(xiě)CUDA內(nèi)核

      通常,實(shí)時(shí)物理模擬代碼是用低級(jí) CUDA C ++編寫(xiě)的,以獲得最佳性能。在這篇文章中,我們將介紹 NVIDIA Warp ,這是一個(gè)新的 Python 框架,可以輕松地用 Python
    的頭像 發(fā)表于 04-02 16:15 ?2582次閱讀

    代碼編程規(guī)范的排版風(fēng)格

    程序塊采用縮進(jìn)風(fēng)格編寫(xiě),縮進(jìn)可以使程序更有層次感,每次縮進(jìn)一般為 4 個(gè)空格(部分要求為一個(gè)制表符Tab;我個(gè)人喜歡用空格,因?yàn)橹票矸煌庉嬈骺s進(jìn)不同,雖然能設(shè)置,但是麻煩)
    的頭像 發(fā)表于 02-15 14:56 ?1859次閱讀
    <b class='flag-5'>代碼</b>編程<b class='flag-5'>規(guī)范</b>的排版<b class='flag-5'>風(fēng)格</b>

    FPGA的Verilog代碼編寫(xiě)規(guī)范

      注:以R起頭的是對(duì)編寫(xiě)Verilog代碼的IP設(shè)計(jì)者所做的強(qiáng)制性規(guī)定,以G起頭的條款是建議采用的規(guī)范。每個(gè)設(shè)計(jì)者遵守本規(guī)范可鍛煉命名規(guī)范
    的頭像 發(fā)表于 08-15 16:23 ?2246次閱讀

    python怎樣運(yùn)行代碼

    Python是一種廣泛使用的編程語(yǔ)言,用于開(kāi)發(fā)各種類型的應(yīng)用程序。它具有簡(jiǎn)單易學(xué)的語(yǔ)法和強(qiáng)大的功能,可以用于編寫(xiě)簡(jiǎn)單的腳本、開(kāi)發(fā)桌面應(yīng)用、構(gòu)建Web應(yīng)用、進(jìn)行科學(xué)計(jì)算等多種用途。在本文中,我們將詳細(xì)
    的頭像 發(fā)表于 11-22 10:31 ?1335次閱讀

    python軟件怎么運(yùn)行代碼

    理解的機(jī)器代碼。 在本文中,我們將詳細(xì)介紹如何運(yùn)行Python代碼。我們將探討以下幾個(gè)方面:安裝Python,設(shè)置環(huán)境變量,選擇一個(gè)集成開(kāi)發(fā)環(huán)境(IDE)或文本編輯器,
    的頭像 發(fā)表于 11-28 16:02 ?914次閱讀

    python軟件IDLE怎么打多行代碼

    用于編寫(xiě)、編輯和運(yùn)行Python代碼的編輯器窗口。在IDLE中編寫(xiě)多行代碼有幾種方法可以實(shí)現(xiàn)。 使用括號(hào)與換行符: 在IDLE中
    的頭像 發(fā)表于 11-29 15:00 ?4122次閱讀
    主站蜘蛛池模板: 日本级毛片免费观看| 国模久久| h网站在线| 久久草在线视频国产一| 午夜寂寞影| 手机在线看a| 加勒比黑人喝羽月希奶水| 热门国产xvideos中文| 加勒比精品久久一区二区三区| 国产美女久久久久| 免费特黄视频| 天天干夜夜骑| 久久久久国产精品免费看| 2021国产精品自在拍在线播放| 黄色网址免费在线| 四虎东方va私人影库在线观看| 18满xo影院视频免费体验区| 91学院派女神| 911色_911色sss在线观看| 久久精品国产精品亚洲精品| 日本在线不卡免| 一级特黄a大片免费| 色色免费| 日本免费三级网站| 色婷婷狠狠| 精品综合久久久久久98| 狠狠色噜噜狠狠狠狠| 夜夜嗷| 天天躁狠狠躁狠狠躁夜夜躁| 午夜100| 国产精品资源| 欧美丝袜一区| 中文在线三级中文字幕| 在线久综合色手机在线播放| 亚洲色图 欧美| 天堂网在线最新版www中文网| 一级 黄 色 毛片| 欧美激情亚洲色图| 久久综合九色综合精品| 国产三级精品在线观看| 亚洲一区色|