python语言变量命名规则：Python语言变量命名规则详解

来源：网络作者：日期：2025-11-04 07:56:25

Python作为一门简洁高效的编程语言,其变量命名规则虽然看似简单，但却是编写清晰、可维护代码的基础，本文将详细解析Python变量命名的核心规则，帮助开发者避免常见错误，提升代码质量。

变量命名的基本规则

字母、数字、下划线的组合
Python变量名可以包含英文字母（大小写不限）、数字以及下划线（_），但需要注意的是，变量名不能以数字开头，因为这会导致语法错误。
```
# 正确示例
user_name = "Alice"
age_2023 = 25
# 错误示例
2023_age = 25  # 以数字开头，错误
```
区分大小写
Python是大小敏感的语言，变量名中的大小写会影响其意义。userName和username被视为两个不同的变量。
```
userName = "Alice"
username = "Bob"
print(userName)  # 输出Alice
print(username)  # 输出Bob
```
命名长度无限制，但宜简洁
虽然Python允许创建任意长度的变量名，但过长的变量名可能会降低代码的可读性，建议在简洁和清晰之间找到平衡。

使用蛇形命名法（Snake Case）
Python社区推荐使用蛇形命名法，即变量名由多个单词组成时，单词之间以下划线分隔，且所有字母小写。
```
# 正确示例
first_name = "John"
total_amount = 100.50
# 避免使用驼峰命名法
firstName = "John"  # 不推荐，但Python允许
```
避免使用Python关键字
不能将Python关键字（如if、for、class等）用作变量名，否则会导致语法错误或逻辑混乱。
```
# 错误示例
if = "condition"  # 使用关键字作为变量名，错误
```
使用有意义的名称
变量名应能清晰表达其用途或内容，避免使用无意义的缩写或单个字母（除非在特定上下文中，如循环变量）。
```
# 正确示例
user_age = 25
total_price = 100.50
# 避免使用
a = 25  # 意义不明
x = 100.50  # 同样缺乏可读性
```
模块级变量使用全大写
对于全局常量（通常不被修改），Python社区习惯使用全大写字母和下划线。
```
# 常量命名示例
MAX_CONNECTIONS = 100
PI = 3.14159
```

单下划线开头的变量（_variable）
在Python中，单下划线开头的变量被视为“私有变量”，通常表示该变量或函数为模块内部使用，不应被外部直接访问。
```
_internal_var = 100  # 内部变量，不建议外部访问
```
双下划线开头的变量（__variable）
双下划线开头的变量会被Python解释器自动重命名，实现名称的“名称修饰”（Name Mangling），用于模拟私有变量。
```
__private_var = 200  # 实际存储为 _ClassName__private_var
```
避免使用内置函数名
不要使用Python内置函数或类型（如list、str、int等）作为变量名，以免覆盖内置功能。
```
# 错误示例
list = [1, 2, 3]  # 覆盖了内置的list类型
```