Python标识符的定义规则与使用注意事项详解

# 这些"名字"都是标识符
student_name = '小明'        # 变量名（标识符）
def calculate_average():      # 函数名（标识符）
    total_score = 0           # 变量名（标识符）
    for score in scores:      # 变量名（标识符）
        total_score += score
    return total_score

class studentrecord:          # 类名（标识符）
    def __init__(self, name): # 方法名 + 参数名（都是标识符）
        self.name = name      # 属性名（标识符）

# 用程序判断一个字符串是否是合法的标识符
import keyword

def check_identifier(name):
    """检查一个字符串是否能用作标识符"""
    if keyword.iskeyword(name):
        return f'"{name}" 是关键字，不能用作标识符'
    elif name.isidentifier():
        return f'"{name}" 是合法的标识符'
    else:
        return f'"{name}" 不是合法的标识符'

# 测试
print(check_identifier('hello'))      # 合法的标识符
print(check_identifier('if'))         # 是关键字
print(check_identifier('123abc'))     # 不是合法的标识符
print(check_identifier('my-var'))     # 不是合法的标识符

# ✅ 合法的开头
name = '正确'       # 字母开头
_name = '正确'      # 下划线开头
name = '正确'       # 大写字母开头
变量 = '正确'       # python 3支持中文变量名（但不推荐）

# ❌ 非法的开头
1name = '错误'      # 数字开头
@name = '错误'      # 特殊符号开头
-name = '错误'      # 连字符开头

# ✅ 合法的标识符
student1 = '正确'        # 字母+数字
student_name = '正确'    # 字母+下划线+字母
_file_2 = '正确'         # 下划线+字母+下划线+数字
max_size_100 = '正确'    # 大写字母+下划线+数字

# ❌ 非法的标识符
student-name = '错误'    # 连字符
student.name = '错误'    # 句号
student name = '错误'    # 空格
student@home = '错误'    # @符号

# ❌ 这些都是关键字，不能用作标识符
if = 10
class = '历史课'
for = 3
true = '假'       # python 3中true是关键字，不能赋值
none = '有值'     # none也是关键字

# 这是三个不同的变量！
name = '小明'
name = '小红'
name = '小刚'

print(name)   # 小明
print(name)   # 小红
print(name)   # 小刚

# 常见的pep 8惯例
max_size = 100        # 常量用全大写
max_size = 100        # 普通变量用小写

# 变量名、函数名、方法名：snake_case（蛇形命名）
student_count = 42
def calculate_average(scores):
    pass

# 类名、异常名：pascalcase（帕斯卡命名）
class studentrecordmanager:
    pass

class invalidinputerror(exception):
    pass

# 常量：upper_snake_case（大写蛇形命名）
max_retry_count = 3
database_url = 'postgresql://localhost/mydb'

# 模块名：简短的小写字母（可加下划线）
import data_utils
import http_client

# 包名：简短的小写字母（不加下划线）
# 例如：mypackage, utils, models

class myclass:
    def __init__(self):
        self.public_attr = '公共属性'     # 公开访问
        self._internal_attr = '内部属性'  # _ 前缀：约定"内部使用"
        self.__private_attr = '私有属性'  # __ 前缀：名称改写

    def public_method(self):
        """公开方法"""
        pass

    def _internal_method(self):
        """内部方法——约定不在类外部调用"""
        pass

    def __private_method(self):
        """私有方法——python自动改写名称"""
        pass

# ❌ 避免用双下划线开头和结尾（保留给python的魔术方法）
# 不要自己创建类似 __name__ 这样的标识符
class badclass:
    def __my_custom_magic__(self):   # 危险！可能在未来python版本中变成关键字
        pass

# ❌ 避免下划线后跟大写字母（保留给某些特定用途）
_private = '虽然合法，但不推荐'

# ❌ 避免单个下划线后跟数字（有些代码检查工具会警告）
_1st_place = '不推荐'

# python 3支持中文标识符（但不推荐在生产代码中使用）
学生姓名 = '小明'
年龄 = 20
def 打招呼(名字):
    print(f'你好，{名字}！')

打招呼(学生姓名)  # 你好，小明！

# ✅ 合法（但不推荐）
café = '法语单词'
naïve = '分音符'
γ = 0.57721  # 希腊字母gamma

# ❌ 非法
🐍 = 'python'  # emoji不能用作标识符

# 技术上合法，但导致内置函数无法使用
print = '我把print重定义了'
# print('hello')  # typeerror! print现在是字符串，不能调用

# 恢复原来的print
del print  # 删除变量print，就恢复了对内置print的访问
print('现在print又正常了')

# 不要用这些内置名称作标识符
# 常用函数
# print, input, len, sum, max, min, abs, round
# type, int, str, float, bool, list, dict, set, tuple
# range, enumerate, zip, map, filter, sorted, reversed
# open, file, id, dir, help, exit, quit
# object, property, classmethod, staticmethod

# ❌ 示例：遮盖了内置函数
list = [1, 2, 3]           # 变量名list遮盖了内置函数list()
# list('hello')             # typeerror! list现在是列表对象

# ✅ 变通方法
# 如果确实需要用这些词作变量名，在后面加下划线
list_ = [1, 2, 3]          # 尾部加下划线
type_ = '学生'              # 尾部加下划线

# 四层作用域示例
x = '全局变量'                    # global作用域

def outer_function():
    y = '外层函数变量'            # enclosing作用域

    def inner_function():
        z = '内层函数变量'        # local作用域

        print(z)                # 访问local
        print(y)                # 访问enclosing
        print(x)                # 访问global
        print(len)              # 访问built-in

    inner_function()

outer_function()

# 局部变量会屏蔽全局变量
count = 100      # 全局

def my_function():
    count = 10   # 局部——这个名字在函数内部"屏蔽"了全局count
    print(f'内部count: {count}')

my_function()    # 内部count: 10
print(f'全局count: {count}')  # 全局count: 100

# 这些看起来一样，其实不一样！
# 注意区分：
# 数字 0 vs 字母 o（大写的o）
# 数字 1 vs 字母 l（小写的l）vs 字母 i（大写的i）

# ❌ 非常容易混淆
o0 = '一个是字母o，一个是数字0'
il = '一个是大写i，一个是小写l'

# 有些时候，复制粘贴代码可能会带入不可见的unicode字符
# 例如：零宽空格(u+200b)、零宽连接符(u+200c)

# 如果遇到奇怪的syntaxerror，
# 尝试在ide中开启"显示不可见字符"功能

# ❌ 太长了
the_total_number_of_active_users_in_the_current_session = 42

# ✅ 合理的长度
active_user_count = 42
session_active_users = 42

# 原始代码（有一些命名问题）
import keyword

class user_manager:           # 类名应该是pascalcase
    max_user_count = 100      # 常量应该全大写，这个混合了

    def __init__(self, name, email, 1st_login=false):
        # 参数name应该是name（小写）
        # 参数email应该是email（小写）
        # 参数1st_login不合法（数字开头）
        self.name = name
        self.email = email
        self._1st_login = false

    def get_users(self):       # 方法名应该是snake_case
        """获取用户列表"""
        list = []              # 变量名遮盖了内置函数list()
        for i in range(10):    # 循环变量i可以接受
            list.append(i)
        return list

import keyword

class usermanager:              # ✅ pascalcase类名
    max_user_count = 100        # ✅ 全大写常量

    def __init__(self, name, email, is_first_login=false):
        # ✅ snake_case参数名
        self.name = name
        self.email = email
        self.is_first_login = is_first_login  # ✅ 避免数字开头

    def get_users(self):        # ✅ snake_case方法名
        """获取用户列表"""
        user_list = []          # ✅ 避免遮盖内置函数
        for i in range(10):
            user_list.append(i)
        return user_list