Python的秘密生活：暗影之名

Source: Dev.to

请提供您希望翻译的完整文本内容，我将按照您的要求将其翻译为简体中文并保留原始的格式、Markdown 语法以及技术术语。谢谢！

Source: …

理解变量遮蔽（Variable Shadowing）与内置函数（Built‑ins）

Timothy盯着屏幕，眉头紧锁。

“Margaret？我这次真的把 Python 弄坏了。”

Margaret抬起手中的茶杯。

“这可是个大胆的说法，Timothy。你怎么会这么说？”

“是 list() 函数，”Timothy指着显示器说，“我已经用了千百次来转换数据。但现在 Python 却说它不再工作了。提示列表‘不可调用’。”

代码中的问题

# Timothy 用来处理客户 ID 的脚本

# 步骤 1：创建当前 ID 的列表
list = [101, 102, 103]
print(f"Current IDs: {list}")

# 步骤 2：把新 ID 的元组转换为列表
new_ids_tuple = (201, 202, 203)
processed_ids = list(new_ids_tuple)  # “看到了吗？” Timothy 争辩道。“我想用 `list()` 把元组转换成列表。但 Python 说 list 对象不可调用。什么时候 list 函数不能被调用了？”

Margaret 温柔地笑了笑。“Python 工作得很正常，Timothy。问题在于你抢走了它的名字标签。”

LEGB 规则

Margaret 在白板上写下四个字母：L.E.G.B.

• Local Scope（局部作用域） – 当前函数内部
• Enclosing Scope（闭包作用域） – 嵌套函数
• Global Scope（全局作用域） – 主脚本
• Built‑in Scope（内置作用域） – Python 的核心工具

“像 list、str、print、max 这样的名字位于 Built‑in Scope——工具箱的最底层。
Python 允许你在 Global Scope 中创建变量。当你写 list = [101, 102, 103] 时，你在内置的 list 之上放了一个同名标签。
所以当代码执行到步骤 2 并调用 list(new_ids_tuple) 时，Python 先找到了你的全局变量，停止继续查找，结果尝试调用一个列表对象，而列表对象是不可调用的。”

变量遮蔽（Variable Shadowing）

Timothy 叹了口气。“Python 为什么会允许我这么做？为什么不直接禁止我使用 list 这个词？”

“因为 Python 认为你是一个有自主权的成年人，” Margaret 回答道。“高级用户有时需要覆盖内置行为，以便进行测试或使用特殊框架。Python 给了你修改任何东西的权力——即使这意味着你偶尔会绊到自己的鞋带。”

“所以我刚才把工具用自己的变量给遮蔽了，” Timothy 说。
“没错，这叫 变量遮蔽（Variable Shadowing）。”

解决办法

# Margaret 的修正：使用描述性命名

# 步骤 1：使用描述性的名称，而不是保留字
current_ids = [101, 102, 103]
print(f"Current IDs: {current_ids}")

# 步骤 2：此时 `list` 仍指向内置函数
new_ids_tuple = (201, 202, 203)
processed_ids = list(new_ids_tuple)  # 完美运行！

print(f"Processed: {processed_ids}")

输出

Current IDs: [101, 102, 103]
Processed: [201, 202, 203]

“好多了，” Timothy 说。“而且 current_ids 实际上告诉我数据是什么，而不仅仅是它的类型。”

常见陷阱

快速检查：如果你的变量名在代码编辑器中显示为特殊颜色（通常是紫色或蓝色），请考虑重命名，以避免与内置名称冲突。

Timothy 记下了笔记。

“我现在对指责 Python 感到很内疚。它只是按我告诉它的去做而已。”

Margaret 微笑着。

“大多数情况下确实如此。”

both its greatest strength and its greatest frustration.”

敬请期待下一集，蒂莫西将了解为什么将字符串 "5" 与数字 5 进行比较在某些情况下会悄然失败或导致崩溃。