Python 下划线完整指南：从单下划线到双下划线的命名规则与实战

Python 下划线概述

在 Python 中，下划线（_）字符拥有多种用途，其具体含义主要取决于使用场景和上下文。与 Python 中的许多其他特性类似，下划线的使用更多是一种社区惯例而非强制语法，但理解这些惯例对于编写清晰、可维护的代码至关重要。本文将系统梳理下划线在变量命名、类定义、数字格式及交互环境中的不同表现形式。

1. 单下划线（例如 _）
2. 名称前加一个下划线（例如 _total）
3. 名称后加一个下划线（例如 total_）
4. 数字文字中的单个下划线（例如 100_000）
5. 名称前加上双下划线（例如 __total）
6. 名称前后加双下划线（例如 __init__）

单下划线（_）的三种主要用途

一、单下划线（_）的常见场景

单下划线在 Python 中主要出现在以下三种典型场景中：

1. 在交互式解释器中作为结果引用

在交互式解释器会话中，单下划线（_）被用作存储最后执行语句结果的变量。这一特性最初由标准 CPython 解释器引入，随后其他 Python 实现也陆续跟进支持。例如，在计算完成后输入 _ 即可获取上一步的计算结果。

>>> _ 
Traceback (most recent call last): 
  File "<stdin>", line 1, in <module> 
NameError: name '_' is not defined 
>>> 42 
>>> _ 
42 
>>> 'alright!' if _ else ':(' 
'alright!' 
>>> _ 
'alright!' 

2. 作为一次性占位符名称

这与上述交互解释器的用法有一定关联，但更常用于脚本或函数内部。单下划线在此处被用作“一次性”变量名，旨在向代码阅读者传达：此处虽然分配了变量，但后续并不会使用其值。例如，当我们需要执行循环但不关心计数器具体数值时，可以使用下划线作为循环变量。

n = 42 
for _ in range(n): 
    do_something() 

3. 国际化（i18n）函数别名

在涉及国际化和本地化的代码中，单下划线常被用作执行字符串翻译查找的函数名。这种做法源于 C 语言的相关惯例，并在 Django 等框架中得到广泛采用。通过导入 gettext 模块并将翻译函数别名为 _，开发者可以简洁地调用翻译逻辑。

from django.http import HttpResponse 
from django.utils.translation import gettext as _ 
 
def my_view(request): 
    output = _("Welcome to my site.") 
    return HttpResponse(output) 

需要注意的是，第二种用法（占位符）与第三种用法（i18n 函数）可能存在命名冲突。因此，在同时使用下划线作为一次性变量和国际化翻译函数的代码块中，应避免将 _ 用作一次性变量名，以免引发意外行为。

前缀单下划线：私有约定与导入控制

二、名称前加单下划线（例如 _total）

在名称前添加单个下划线，通常表示该名称应被视为“私有”。这主要是一种代码阅读约定，提示其他开发者该变量或方法仅供内部使用。根据 Python 官方文档的说明，以下划线开头的名称（如 _spam）应被视为 API 的非公开部分，无论是函数、方法还是数据成员。

官方文档指出，带有下划线的名称应被视为实现细节，其内部实现可能在后续版本中更改而不另行通知。之所以称之为“约定”，是因为解释器对其有特殊处理：当使用 `from module import *` 导入模块时，除非模块的 `__all__` 列表明确包含以单下划线开头的名称，否则这些名称不会被导入。这是一种防止意外暴露内部实现的机制。

后缀单下划线：避免关键字冲突

三、名称后加单下划线（例如 total_）

在名称末尾添加单个下划线，主要用于避免与 Python 保留关键字或内置函数发生命名冲突。这是一种约定俗成的做法。例如，如果你希望定义一个名为 `format` 的函数，但由于 `format` 是 Python 的内置函数，直接命名会导致覆盖内置功能，此时可以将其命名为 `format_` 以规避冲突。

数字分组：PEP 515 与可读性优化

四、数字字面量中的单下划线（例如 100_000）

PEP 515 提案扩展了 Python 的语法，允许在整数、浮点数和复数的字面量中使用下划线作为数字分组的可视分隔符。这一设计的初衷是借鉴其他现代编程语言的常见特性，以提高长数字的可读性。

通过下划线分隔，可以清晰地展示数字的结构，如字节数、十六进制地址或二进制位组。其数值本身不受影响，仅用于提升代码的可读性。

具体使用示例如下：

# 十进制数按千分组 
amount = 10_000_000.0 
 
# 按字对十六进制地址进行分组 
addr = 0xCAFE_F00D 
 
# 用二进制文字将位分组为半字节 
flags = 0b_0011_1111_0100_1110 
 
#相同，用于字符串转换 
flags = int('0b_1111_0000', 2) 

前缀双下划线：名称修饰与防覆盖机制

五、名称前加双下划线（例如 __total）

在名称前使用双下划线（__）并非仅仅是约定，而是对解释器具有特殊语义的操作。Python 解释器会自动处理这些名称，旨在避免子类定义的名称与父类名称发生冲突。根据 Python 文档，任何形式为 `__spam` 的标识符（至少两个前导下划线，且最多一个尾随下划线）在编译时会被替换为 `_classname__spam`，其中 `classname` 是当前类名（去除了前导下划线）。

通过以下示例可以清晰看到这一机制：

>>> class A(object): 
...     def _internal_use(self): 
...         pass 
...     def __method_name(self): 
...         pass 
...  
>>> dir(A()) 
['_A__method_name', ..., '_internal_use'] 

如上所示，`_internal_use` 保持不变，而 `__method_name` 被解释器自动重命名为 `_ClassName__method_name`。这意味着，如果你创建了类 A 的子类 B（即使命名不当），子类 B 也无法轻易覆盖或访问父类 A 的 `__method_name`，因为名称已经被修饰。

>>> class B(A): 
...     def __method_name(self): 
...         pass 
...  
>>> dir(B()) 
['_A__method_name', '_B__method_name', ..., '_internal_use'] 

这种名称修饰机制的预期行为类似于 Java 中的 final 方法或 C++ 中的常规（非虚）方法，旨在防止子类意外覆盖父类的内部实现。

前后双下划线：魔术方法与特殊系统接口

六、名称前后加双下划线（例如 __init__）

这类名称是 Python 系统预定义的特殊方法名称，通常被称为“魔术方法”或“dunder methods”。对于开发者而言，这是一种约定，即 Python 系统使用以双下划线开头和结尾的名称来避免与用户自定义名称冲突。我们通常通过重写这些方法（如 `__init__`）来定义类在特定操作下的行为。

虽然技术上允许开发者定义自己的特殊方法名称（以双下划线包裹），但强烈建议不要这样做，除非你非常清楚其后果。

>>> class C(object): 
...     def __mine__(self): 
...         pass 
... 
>>> dir(C) 
... [..., '__mine__', ...] 

最佳实践是遵循 Python 预定义的特殊方法命名约定，不要自行发明以双下划线包裹的方法名，以免与未来 Python 版本引入的新特性产生冲突。

以上便是 Python 中各种下划线用法的详细解析。掌握这些规则有助于编写更规范、安全且易于维护的 Python 代码。如需了解更多 Python 相关技巧，请持续关注本站其他技术文章。