Python变量命名规则：避免常见错误的实用技巧

良好的变量命名是编写可读、可维护Python代码的基础。本文将深入探讨Python变量命名的核心规则、常见陷阱以及提升命名质量的实用技巧。

一、Python命名基本规则

1.1 合法命名的语法要求

• 允许字符：字母（a-z, A-Z）、数字（0-9）和下划线（_）
• 首字符限制：不能以数字开头
• 大小写敏感：my_var与My_Var是不同的变量
• 关键字冲突：避免使用Python关键字（如class, def, if等）

合法示例：

count = 10
user_name = "Alice"
_total = 100
MAX_SIZE = 1024

非法示例：

2nd_place = "Bob"  # 数字开头
user-name = "Alice" # 包含连字符
class = "Biology"   # 使用关键字

二、命名风格规范（PEP 8）

2.1 主要命名风格

2.2 风格混用的危害

# 不推荐的混用风格
customerName = "Alice"  # 变量使用驼峰
CalculateTotal()        # 函数使用大驼峰

三、常见错误与修正

3.1 模糊/无意义的命名

错误示例：

x = 10      # 什么含义？
temp = []   # 临时存储什么？
def func(): # 什么功能？

改进方案：

retry_count = 10
pending_orders = []
def calculate_tax():

3.2 过度缩写

错误示例：

usr_cnt = 100      # user_count
cust_det = {
   
   }      # customer_details
def calc_tx():     # calculate_tax

改进方案：

user_count = 100
customer_details = {
   
   }
def calculate_tax():

3.3 类型信息冗余

错误示例：

name_string = "Alice"
list_data = [1, 2, 3]
def process_data(data_list):

改进方案：

name = "Alice"
data = [1, 2, 3]
def process(items):

3.4 误导性命名

错误示例：

users = "Alice"    # 变量名复数但实际是单数
is_active = 1      # 布尔变量但用整数

改进方案：

user = "Alice"
is_active = True

四、上下文相关的命名技巧

4.1 循环变量命名

普通循环：

for i in range(10)