欧美成人精品手机在线观看_69视频国产_动漫精品第一页_日韩中文字幕网 - 日本欧美一区二区

http://static.oschina.net/uploads/space/2016/0603/111931_888o_2758756.jpg" width="500">

1，Python編程規(guī)范

> 編碼

所有的 Python 腳本文件都應(yīng)在文件頭標(biāo)上

# -*- coding:utf-8 -*- 

用于設(shè)置編輯器，默認(rèn)保存為 utf-8 格式。

> 注釋

業(yè)界普遍認(rèn)同 Python 的注釋分為兩種，

• 一種是由 # 開(kāi)頭的“真正的”注釋?zhuān)?，用于表明為何選擇當(dāng)前實(shí)現(xiàn)以及這種實(shí)現(xiàn)的原理和難點(diǎn)
• 另一種是 docstrings，例如，用于表明如何使用這個(gè)包、模塊、類(lèi)、函數(shù)（方法），甚至包括使用示例和單元測(cè)試

堅(jiān)持適當(dāng)注釋原則。對(duì)不存在技術(shù)難點(diǎn)的代碼堅(jiān)持不注釋?zhuān)瑢?duì)存在技術(shù)難點(diǎn)的代碼必須注釋。但與注釋不同，建議對(duì)每一個(gè)包、模塊、類(lèi)、函數(shù)（方法）寫(xiě) docstrings，除非代碼一目了然，非常簡(jiǎn)單。

> 縮進(jìn)

Python 依賴縮進(jìn)來(lái)確定代碼塊的層次，行首空白符主要有兩種：tab 和 空格，但嚴(yán)禁兩者混用。如果使用 tab 縮進(jìn)，設(shè)定tab 為 4 個(gè)空格。

>  空格

空格在 Python 代碼中是有意義的，因?yàn)?Python 的語(yǔ)法依賴于縮進(jìn)，在行首的空格稱(chēng)為前導(dǎo)空格。在這一節(jié)不討論前導(dǎo)空格相關(guān)的內(nèi)容，只討論非前導(dǎo)空格。非前導(dǎo)空格在 Python 代碼中沒(méi)有意義，但適當(dāng)?shù)丶尤敕乔皩?dǎo)空格可以增進(jìn)代碼的可讀性。

    1） 在二元算術(shù)、邏輯運(yùn)算符前后加空格：如

a = b + c;

   2） 在一元前綴運(yùn)算符后不加空格，如

if !flg: pass;

    3） “:”用在行尾時(shí)前后皆不加空格，如分枝、循環(huán)、函數(shù)和類(lèi)定義語(yǔ)言；用在非行尾時(shí)兩端加空格，如：

dict 對(duì)象的定義

d = {＇key＇ :  ＇value＇}

    4） 括號(hào)（含圓括號(hào)、方括號(hào)和花括號(hào)）前后不加空格，如：

do_something(arg1, arg2)

    而不是

do_something( arg1, arg2 )

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

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

>  空行

適當(dāng)?shù)目招杏欣谠黾哟a的可讀性，加空行可以參考如下幾個(gè)準(zhǔn)則：

    1） 在類(lèi)、函數(shù)的定義間加空行；

    2） 在 import 不同種類(lèi)的模塊間加空行；

    3） 在函數(shù)中的邏輯段落間加空行，即把相關(guān)的代碼緊湊寫(xiě)在一起，作為一個(gè)邏輯段落，段落間以空行分隔；

>  斷行

盡管現(xiàn)在的寬屏顯示器已經(jīng)可以單屏顯示超過(guò) 256 列字符，但本規(guī)范仍然堅(jiān)持行的最大長(zhǎng)度不得超過(guò) 80   個(gè)字符的標(biāo)準(zhǔn)。折疊長(zhǎng)行的方法有以下幾種方法：

    1) 為長(zhǎng)變量名換一個(gè)短名，如：

this.is.a.very.long.variable_name = this.is.another.long.variable_name

      應(yīng)改為：

variable_name1 = this.is.a.very.long.variable_name
variable_name2 = this.is.another.variable_name
variable_name1 = variable_name2s

    2) Python會(huì)將圓括號(hào)、中括號(hào)和花括號(hào)中的行隱式的連接起來(lái)，你可以利用這個(gè)特點(diǎn)。如需要，你可以在表達(dá)式外圍增加一對(duì)額外的圓括號(hào)

    3) 在長(zhǎng)行加入續(xù)行符強(qiáng)行斷行，斷行的位置應(yīng)在操作符前，且換行后多一個(gè)縮進(jìn)，以使維護(hù)人員看代碼的時(shí)候看到代碼行首即可判定這里存在換行，如：

if color == WHITE or color == BLACK     or color == BLUE: # 注意 or 操作符在新行的行首而不是舊行的行尾
do_something(color);

>  字符串

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

    2）  為多行字符串使用三重雙引號(hào)而非三重單引號(hào)。不過(guò)要注意, 通常用隱式行連接更清晰，因?yàn)槎嘈凶址c程序其他部分的縮進(jìn)方式不一致。

>  命名

一致的命名可以給開(kāi)發(fā)人員減少許多麻煩，而恰如其分的命名則可以大幅提高代碼的可讀性，降低維護(hù)成本。

>>  常量

常量名所有字母大寫(xiě)，由下劃線連接各個(gè)單詞，如

WHITE = 0XFFFFFF
THIS_IS_A_CONSTANT = 1

>>  變量

變量名全部小寫(xiě)，由下劃線連接各個(gè)單詞，如

color = WHITE
this_is_a_variable = 1

私有類(lèi)成員使用單一下劃線前綴標(biāo)識(shí)，多定義公開(kāi)成員，少定義私有成員。

變量名不應(yīng)帶有類(lèi)型信息，因?yàn)?Python 是動(dòng)態(tài)類(lèi)型語(yǔ)言。如 iValue、names_list、dict_obj 等都是不好的命名。

>>  函數(shù)

函數(shù)名的命名規(guī)則與變量名相同。

>>  類(lèi)

對(duì)類(lèi)名使用大寫(xiě)字母開(kāi)頭的單詞（如CapWords, 即Pascal風(fēng)格），不使用下劃線連接單詞。如：

class ThisIsAClass(object):pass

>>  模塊

模塊名全部小寫(xiě)，對(duì)于包內(nèi)使用的模塊，可以加一個(gè)下劃線前綴，如

module.py
_internal_module.py

>>  包

包的命名規(guī)范與模塊相同。

>>  縮寫(xiě)

命名應(yīng)當(dāng)盡量使用全拼寫(xiě)的單詞，縮寫(xiě)的情況有如下兩種：

    1） 常用的縮寫(xiě)，如 XML、ID等，在命名時(shí)也應(yīng)只大寫(xiě)首字母，如

class XmlParser(object):pass

    2） 命名中含有長(zhǎng)單詞，對(duì)某個(gè)單詞進(jìn)行縮寫(xiě)。這時(shí)應(yīng)使用約定成俗的縮寫(xiě)方式，如去除元音、包含輔音的首字符等方式，例如：

        function 縮寫(xiě)為 fn

        text 縮寫(xiě)為 txt

        object 縮寫(xiě)為 obj

        count 縮寫(xiě)為 cnt

        number 縮寫(xiě)為 num，等。

>>  特定命名方式

主要是指 __xxx__ 形式的系統(tǒng)保留字命名法。項(xiàng)目中也可以使用這種命名，它的意義在于這種形式的變量是只讀的，這種形式的類(lèi)成員函數(shù)盡量不要重載。如

class Base(object):
    def __init__(self, id, parent =None):
        self.__id__ = id
        self.__parent__ = parent
    def __message__(self, msgid):
        # …略

其中 __id__、__parent__ 和 __message__ 都采用了系統(tǒng)保留字命名法。

>>  導(dǎo)入格式

    1） import 的次序，先 import Python 內(nèi)置模塊，再 import 第三方模塊，最后 import 自己開(kāi)發(fā)的項(xiàng)目中的其它模塊；這幾種模塊用空行分隔開(kāi)來(lái)。

    2） 每個(gè)import應(yīng)該獨(dú)占一行。

    3） 不要使用 from module import *，除非是 import 常量定義模塊或其它你確保不會(huì)出現(xiàn)命名空間沖突的模塊。

>  賦值

對(duì)于賦值語(yǔ)言，主要是不要做無(wú)謂的對(duì)齊，如：

a            = 1                               # 這是一個(gè)行注釋
variable = 2                               # 另一個(gè)行注釋
fn           = callback_function    # 還是行注釋

沒(méi)有必要做這種對(duì)齊，原因有兩點(diǎn)：一是這種對(duì)齊會(huì)打亂編程時(shí)的注意力，大腦要同時(shí)處理兩件事（編程和對(duì)齊）；二是以后閱讀和維護(hù)都很困難，因?yàn)槿搜鄣臋M向視野很窄，把三個(gè)字段看成一行很困難，而且維護(hù)時(shí)要增加一個(gè)更長(zhǎng)的變量名也會(huì)破壞對(duì)齊。直接這樣寫(xiě)為佳：

a = 1 # 這是一個(gè)行注釋
variable = 2 # 另一個(gè)行注釋
fn = callback_function # 還是行注釋

>  語(yǔ)句

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

2，參考資料

• http://wenku.baidu.com/link?url=ArnV_IaWvSHIas6LR_Atcx8VyqJQ30A2ugKcCA3sVDwcUsTeIEaxT9sy6cehI-Gd61tILaPFeMw07YFfifo0v-njaD_-RS5zO1ZYlsPRTjq" target="_blank" rel="nofollow">Google Python編程風(fēng)格指南

3，文檔修改歷史

2016-06-03：V1.0