怎么查看Python所有关键字以避免变量名冲突？

在编写 Python 代码时，如果你尝试给一个变量命名为 def、class 或 for，解释器会立即抛出 SyntaxError: invalid syntax 错误。这是因为 Python 将一部分特定词汇保留作为语法结构的核心组成部分，这些词汇被称为“保留关键字”（Reserved Keywords）。想要彻底避免命名冲突，核心方法就是使用 Python 标准库内置的 keyword 模块快速获取并核验当前版本的关键字清单。

一、使用 keyword 模块查看完整关键字列表

Python 官方标准库提供了一个专门的模块 keyword，用于检测字符串是否为关键字以及列出当前解释器环境中的所有关键字。这个模块随 Python 一同安装，无需任何第三方包依赖。

你可以打开终端或交互式环境（REPL），通过以下两行代码打印全部关键字：

import keyword

# 打印所有关键字列表
print(keyword.kwlist)

在 Python 3 较新版本中，输出结果形如下面的 Python 列表（示例）：

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

如果你想快速统计当前环境中的关键字数量，也可以直接使用内置的 len() 函数：

print(f"当前 Python 版本的关键字数量为：{len(keyword.kwlist)}")

二、通过代码动态判定：iskeyword 函数

除了肉眼对照列表，在编写代码解析器、动态接收外部字段（如 JSON 数据映射为对象属性）或配置动态变量时，更推荐使用 keyword.iskeyword() 进行程序化断言。

import keyword

# 检查特定名称是否是关键字
print(keyword.iskeyword("def"))      # 输出: True
print(keyword.iskeyword("total"))    # 输出: False
print(keyword.iskeyword("class"))    # 输出: True
print(keyword.iskeyword("Class"))    # 输出: False（Python大小写敏感）

值得注意的是，Python 对大小写非常敏感。关键字 class 是纯小写，因此 keyword.iskeyword("class") 返回 True，而首字母大写的 Class 并不是关键字（但按照惯例通常作为类名使用）。关键字中仅有三个是首字母大写：True、False、None，其余全部为纯小写。

三、关键字与内置函数（Built-in Functions）的区别

很多初学者容易将“关键字”与“内置标识符/内置函数”混淆，这是一种非常普遍但性质完全不同的命名冲突：

• 保留关键字（Keywords）：如 def、class、if、pass。这是语言语法解析的核心。如果尝试对其赋值（例如 pass = 10），解释器在语法解析阶段就会直接报错，程序根本无法启动。
• 内置作用域标识符（Built-ins）：如 list、dict、str、type、id、input、max。这些是存在于 Python 内置命名空间（built-in scope）中的普通对象名。如果给它们赋值（例如 list = [1, 2, 3]），语法上是完全合法的，不会报错，但会导致当前局部或全局作用域中的 list 被覆盖（Shadowing），随后你调用 list() 构造函数时就会引发 TypeError: 'list' object is not callable。

为了同时排查是否命中了内置函数或常用类型，你可以通过内置的 dir(__builtins__) 进行辅助检查：

# 检查是否为内置标识符
print("list" in dir(__builtins__))  # 输出: True
print("keyword" in dir(__builtins__)) # 输出: False

四、避免命名冲突的实践原则

在实际开发过程中，我们经常会遇到必须要表示“类”（class）、“类型”（type）或“导入”（import）概念的业务场景。如何得体地处理这些场景？PEP 8 官方编码风格指南给出了权威指导：

1. 单后置下划线（Single Trailing Underscore）：当变量名与关键字完全冲突时，PEP 8 推荐在末尾追加一个下划线。例如使用 class_ 表示样式类，使用 in_ 表示包含关系过滤参数，使用 type_ 避免覆盖内置 type。
2. 更具体的语义命名：相比于单字的 class_，更好的工程实践是增强变量名的上下文意义。例如将 class 替换为 css_class、category_type 或 target_class，这样不仅规避冲突，还显著增强了代码的可读性。
3. 借助 IDE 与 Linter 静态分析：现代代码编辑器（如 VS Code、PyCharm）和静态检查工具（如 Flake8、Ruff、Pylance）会在你键入关键字作为变量名时高亮标红，并在覆盖内置函数时给出警告提示。