萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 下劃線完整指南:單下劃線、雙下劃線、雙下劃線雙邊的含義與慣例

概述

Python 中下劃線 _ 有多種用法,大多屬於社區約定俗成,少數具有語法語義。正確理解各類下劃線含義,能寫出更符合 Python 風格(Pythonic)的代碼。

一、 單個下劃線 _ 作為變量名

1. 交互式解釋器中的「上一個結果」

>> 42
42
>>> _
42
>>> _ * 2
84

僅在 REPL 中有效,腳本中無此行為。

2. 「拋棄變量」約定

# 循環不需要索引
for _ in range(10):
    do_something()

# 解包忽略某些值
x, _, z = (1, 2, 3)  # 忽略中間值
_, *rest = [1, 2, 3, 4]  # 忽略首元素

向閱讀者明確傳達:「這個值我不關心,不會使用」。

3. 國際化 (i18n) 翻譯函數別名

from django.utils.translation import gettext as _
from django.http import HttpResponse

def my_view(request):
    output = _("Welcome to my site.")
    return HttpResponse(output)

慣例源自 C 語言 gettext。注意:同一作用域內不可同時用作拋棄變量與翻譯函數,會衝突。

二、 單下劃線前綴 _name:內部使用標記

class MyClass:
    def __init__(self):
        self._internal = 0      # 實例內部屬性
        self.public = 1         # 公開屬性

    def _helper(self):          # 內部方法
        pass

def _module_private_func():     # 模塊級私有函數
    pass

含義:標記為「非公共 API 實現細節」,外部代碼不應直接訪問。

機制:

  • from module import * 不會導入下劃線開頭的名稱(除非在 __all__ 列表中)。
  • IDE 可提示為私有,但不強制阻止訪問(Python 無真正私有)。

三、 雙下劃線前綴 __name:名稱重整

這是語法語義,非約定。Python 會將類內部的 __name 自動重寫為 _ClassName__name,以避免子類同名屬性衝突。

演示

>> class A:
...     def _internal(self): pass
...     def __private(self): pass
...
>>> dir(A())
['_A__private', ..., '_internal']

>>> class B(A):
...     def __private(self): pass  # 不會覆蓋 A.__private
...
>>> dir(B())
['_A__private', '_B__private', ...]

適用場景

  • 類內部屬性/方法,防止子類意外覆蓋(如描述符、內部緩存)。
  • 不建議用於普通「私有」標記,單下劃線即可;濫用增加閱讀困難。

四、 雙下劃線前後綴 __name__:魔術方法/特殊屬性

Python 保留用於特定協議的名稱,用戶勿自定義此類名稱:

類別示例用途
對象生命週期__init__, __new__, __del__構造/銷毀
運算符重載__add__, __eq__, __getitem__+, ==, []
容器協議__len__, __iter__, __contains__len(), for, in
上下文管理__enter__, __exit__with 語句
屬性訪問__getattr__, __setattr__點號訪問攔截
內置屬性__name__, __module__, __doc__, __file__模塊/類/函數元信息

五、 總結速查表

形式名稱性質主要目的示例
_單下劃線約定/REPL特殊拋棄值 / 上一結果 / i18n函數for _ in ..., _()
_name單前綴約定內部/非公共 API_private_var
__name雙前綴語法(名稱重整)避免子類衝突__cache → _Class__cache
__name__雙前後綴保留協議魔術方法/特殊屬性__init__, __len__

最佳實踐建議

  1. 內部實現用 _single,清晰表達意圖且無副作用。
  2. 僅在需要防止子類覆蓋時用 __double,並理解其重整機制。
  3. 絕不自定義 __dunder__ 名稱,避免與未來 Python 版本衝突。
  4. REPL 中善用 _ 加速探索式編程。
copyright © 萬盛學電腦網 all rights reserved