[轉]關於python中帶下划線的變量和函數的意義


Python 的代碼風格由 PEP 8 描述。這個文檔描述了 Python 編程風格的方方面面。在遵守這個文檔的條件下,不同程序員編寫的 Python 代碼可以保持最大程度的相似風格。這樣就易於閱讀,易於在程序員之間交流。

1.變量

  • _xxx,單下划線開頭的變量,標明是一個受保護(protected)的變量,原則上不允許直接訪問,但外部類還是可以訪問到這個變量。這只是程序員之間的一個約定,用於警告說明這是一個私有變量,外部類不要去訪問它。
class Student(object):
    def __init__(self, name):
        self._name = name
>>> sd = Student('Tom')
>>> sd._name
'Tom'
  • __xxx,雙下划線開頭的,表示的是私有類型(private)的變量。只能是允許這個類本身進行訪問了, 連子類也不可以,用於命名一個類屬性(類變量),調用時名字被改變(在類Student內部,__name變成_Student__name,如 self._Student__name)
    雙下划線開頭的實例變量是不是一定不能從外部訪問呢?其實也不是。仍然可以通過_Student__name來訪問__name變量:
class Student(object):
    def __init__(self, name):
        self.__name = name
>>> sd = Student('Tom')
>>> sd.__name
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'Student' object has no attribute '__name'
>>> sd._Student__name
'Tom'
  • __xxx__,以雙下划線開頭,並且以雙下划線結尾的,是內置變量,內置變量是可以直接訪問的,不是 private 變量,如__init____import__或是__file__。所以,不要自己定義這類變量。

  • xxx_,單下划線結尾的變量一般只是為了避免與 Python 關鍵字的命名沖突。

  • USER_CONSTANT,大寫加下划線,對於不會發生改變的全局變量,使用大寫加下划線。

2.函數和方法

總體而言應該使用,小寫和下划線。但有些比較老的庫使用的是混合大小寫,即首單詞小寫,之后每個單詞第一個字母大寫,其余小寫。但現在,小寫和下划線已成為規范。

  • 私有方法 : 小寫和一個前導下划線
def _secrete(self):
    print "don't test me."

這里和私有變量一樣,並不是真正的私有訪問權限。同時也應該注意一般函數不要使用兩個前導下划線(當遇到兩個前導下划線時,Python 的名稱改編特性將發揮作用)。特殊函數后面會提及。

  • 特殊方法 : 小寫和兩個前導下划線,兩個后置下划線
def __add__(self, other):
    return int.__add__(other)

這種風格只應用於特殊函數,比如操作符重載等。

  • 函數參數 : 小寫和下划線,缺省值等號兩邊無空格
def connect(self, user=None):
    self._user = user

### 3.類 類總是使用駝峰格式命名,即所有單詞首字母大寫其余字母小寫。類名應該簡明,精確,並足以從中理解類所完成的工作。常見的一個方法是使用表示其類型或者特性的后綴,例如: SQLEngine MimeTypes

對於基類而言,可以使用一個 Base 或者 Abstract 前綴

BaseCookie
AbstractGroup
class UserProfile(object):
    def __init__(self, profile):
        return self._profile = profile

    def profile(self):
        return self._profile

### 4.模塊和包

除特殊模塊 init 之外,模塊名稱都使用不帶下划線的小寫字母。
若是它們實現一個協議,那么通常使用lib為后綴,例如:

import smtplib
import os
import sys

### 5.關於參數
5.1 不要用斷言來實現靜態類型檢測

斷言可以用於檢查參數,但不應僅僅是進行靜態類型檢測。 Python 是動態類型語言,靜態類型檢測違背了其設計思想。斷言應該用於避免函數不被毫無意義的調用。

5.2 不要濫用 *args 和 **kwargs

*args**kwargs 參數可能會破壞函數的健壯性。它們使簽名變得模糊,而且代碼常常開始在不應該的地方構建小的參數解析器。


### 6.其他
6.1 使用 has 或 is 前綴命名布爾元素
is_connect = True
has_member = False
6.2 用復數形式命名序列

members = ['user_1', 'user_2']

6.3 用顯式名稱命名字典

person_address = {'user_1':'10 road WD', 'user_2' : '20 street huafu'}

6.4 避免通用名稱

諸如 list, dict, sequence 或者 element 這樣的名稱應該避免。

6.5 避免現有名稱

諸如 os, sys 這種系統已經存在的名稱應該避免。


### 7.一些數字 一行列數 : PEP 8 規定為 79 列,這有些苛刻了。根據自己的情況,比如不要超過滿屏時編輯器的顯示列數。這樣就可以在不動水平游標的情況下,方便的查看代碼。

一個函數 : 不要超過 30 行代碼, 即可顯示在一個屏幕類,可以不使用垂直游標即可看到整個函數。
一個類 : 不要超過 200 行代碼,不要有超過 10 個方法。
一個模塊 不要超過 500 行。


轉自:關於python中帶下划線的變量和函數 的意義


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM