8、Python标识符命名规则详解：合法命名与常见错误避坑指南

适合人群：零基础自学者 | 编程小白快速入门
阅读时长：约4分钟

一、问题：Python标识符命名规则有哪些？如何避开常见错误？

1、例子1：交通标识牌比喻：合法命名规范解析

比喻：标识符就像交通标识牌，必须符合规范才能被程序理解

# 合法标识符示例（正确交通标识）  
车速 = 60                  # 中文变量名（Python3支持）  
user_age = 25              # 全小写+下划线  
MAX_RETRY = 3              # 常量全大写  
class UserProfile: pass    # 类名首字母大写（驼峰式）  

print("===== 合法标识符 =====")  
print(f"剩余重试次数：{MAX_RETRY}")  
user_profile = UserProfile() 

2、例子2：错误快递标签警示：非法命名引发的SyntaxError

比喻：非法标识符就像贴错标签的快递，导致程序无法识别.

# 非法标识符示例（错误标签）  
2nd_place = "Silver"    # ❌ 数字开头（SyntaxError）  
class yield: pass       # ❌ 使用关键字（SyntaxError）  
user@name = "Tom"       # ❌ 包含特殊字符@  
for = 100               # ❌ 使用关键字for  

print("===== 错误案例 =====")  
# 注释掉错误代码，展示错误提示  
# print(2nd_place)  

3、答案：

（1）什么是标识符，关键字

1. 标识符是变量、函数、类、模块等可以由程序员指定名称的代码元素。构成标识符的字符均遵循一定的命名规则。
2. 关键字是由Python语言本身定义好的有特殊含义的代码元素。你不能用关键字名称给标识符命名。

（2）标识符命名基本规则

标识符命名有如下基本规则：

1. 区分大小写。如： sxt 和 SXT 是不同的。
2. 第一个字符必须是字母（包括中文）、下划线。其后的字符是：字母、数字、下划线。标识符可以包含中文，但不推荐（团队协作易乱码）。
3. 不能使用关键字。比如： if 、 or 、 while 等
4. 以双下划线开头和结尾的名称通常有特殊含义，尽量避免这种写法。比如： __init__ 是类的构造函数

（3）标识符命名详细规则

类型	规则	例子
模块和包名	全小写字母，尽量简单。若多个单词之间用下划线	math, os, sys
函数名	全小写字母，多个单词之间用下划线隔开	phone, my_name
类名	首字母大写，采用驼峰原则。多个单词时，每个单词第一个 字母大写，其余部分小写	MyPhone、 MyClass、Phone
常量名	全大写字母，多个单词使用下划线隔开	SPEED、 MAX_SPEED

（4）关键字有那些

无需刻意去背关键字，后面都会学习。

False	def	if	raise	None	del
import	return	True	elif	in	try
and	else	is	while	as	except
lambda	with	assert	finally	nonlocal	yield
break	for	not	class	from	or
continue	global	pass

二、动手试一试

1. 判断标识符合法性

# 以下哪些是合法标识符？（多选）  
# A. user_name    B. 2nd_round    C. 总人数    D. class    E. MAX_SPEED  

参考答案：A、C、E
解析：B错误：数字开头；D错误：使用关键字。

2. 修复代码命名错误

# 问题代码（包含3处命名错误）  
用户list = ["Alice", "Bob"]  
def printName(用户list):  
    for Name in 用户list:  
        print(Name)  

printName(用户list)  

参考答案：

# 修正后代码 user_list = ["Alice", "Bob"] # 错误1：中文变量名改为蛇形命名
def print_names(user_data): # 错误2：参数名避免中文 | 函数名用蛇形
	for name in user_data: # 错误3：变量名全小写
        print(name)
        
print_names(user_list)

---

📢 互动区
👉 遇到问题？在评论区：

1. 描述问题（带代码截图更好）
2. 分享学习心得
3. 给文章提建议

⭐ 支持作者：点赞 | 收藏 | 关注
你的三连是我更新的最大动力！

---