如何检测Python内置函数名称被其他模块导入覆盖？

数据老陈

2026-6-20

问题背景

我曾使用import *遭遇命名冲突：执行from pyspark.sql.functions import *后，Python内置函数被该导入覆盖。通过代码可看到两者的同名函数列表：

>>> from pprint import pprint
>>> from pyspark.sql import functions as F
>>> pprint(list(set(dir(F)) & set(dir(__builtin__))))
['sum',
 '__package__',
 '__doc__',
 'round',
 'abs',
 'min',
 'bin',
 'filter',
 'ascii',
 '__spec__',
 'hex',
 '__loader__',
 'slice',
 'hash',
 'pow',
 'max',
 '__name__']

尝试与困惑

我尝试检测全局命名空间变化，但结果不符合预期：

>>> ORIGINAL_GLOBALS = globals().copy()
>>> from pyspark.sql.functions import *
>>> MUTATED_GLOBALS = {key: value 
...                    for key, value in globals().items() 
...                    if (key in ORIGINAL_GLOBALS 
...                      and ORIGINAL_GLOBALS[key] != value)}
>>> print(MUTATED_GLOBALS)
{}

本以为会列出被覆盖的函数，但返回空字典。

具体疑问

我是否在正确的位置查询全局命名空间？
如果是，builtins是否存在特殊机制需要考虑？
若builtins存在特殊情况，还有其他类似的隐藏机制吗？

核心问题

有没有符合Python风格的方法检测全局命名空间的变化？

解答

1. 全局命名空间的查询位置问题

你查询的globals()确实是模块级的全局命名空间，但内置函数默认并不直接存放在这里——它们属于builtins模块的命名空间，只有当你在全局作用域显式重新定义同名名称时，才会在globals()里留下条目。from ... import *只会把模块中的名称导入到当前全局命名空间，如果导入的名称和内置函数同名，并不会直接修改builtins，而是在全局命名空间创建一个新的绑定，覆盖对内置函数的引用，但内置函数本身仍在builtins里。

你的检测代码返回空，是因为ORIGINAL_GLOBALS里原本就没有这些内置函数的条目（除非你之前显式定义过），所以key in ORIGINAL_GLOBALS的判断不成立，自然不会被纳入结果。

2. `builtins`的特殊机制

builtins是Python的内置模块，它的命名空间是所有作用域的“兜底”：当你在某个作用域里访问一个名称时，如果当前作用域和全局作用域都找不到，就会去builtins里找。但from ... import *不会修改builtins，只是在当前全局作用域添加同名绑定，让你访问这个名称时优先取全局作用域的新值，而非builtins里的内置函数。

3. 其他类似的隐藏机制

嵌套作用域的遮蔽：比如函数内部的局部变量会遮蔽全局变量，这种情况也不会在globals()里体现变化。
模块的__all__属性：from ... import *只会导入模块__all__列表中指定的名称（如果模块定义了__all__），如果没定义则导入所有非下划线开头的名称，这会影响哪些名称会被导入到全局命名空间。

符合Python风格的检测方法

方法1：对比全局命名空间的新增/修改条目

修改检测逻辑，同时捕获新增和修改的名称：

ORIGINAL_GLOBALS = set(globals().keys())
from pyspark.sql.functions import *
NEW_GLOBALS = set(globals().keys())

# 新增的全局名称
added = NEW_GLOBALS - ORIGINAL_GLOBALS
# 被修改的已有名称
original_dict = globals().copy()
modified = {k: globals()[k] for k in ORIGINAL_GLOBALS & NEW_GLOBALS if globals()[k] != original_dict[k]}

print("新增的全局名称:", added)
print("被修改的全局名称:", modified)

这样就能捕获到from ... import *导入的所有新名称，包括和内置函数同名的条目。

方法2：检测与内置函数的冲突

直接对比全局命名空间和builtins的同名绑定，找出被遮蔽的内置函数：

import builtins

from pyspark.sql.functions import *

shadowed = {}
for name in dir(builtins):
    if name in globals() and globals()[name] is not getattr(builtins, name):
        shadowed[name] = (getattr(builtins, name), globals()[name])

print("被遮蔽的内置函数:", shadowed)

这个方法能直接定位到哪些内置函数被导入的名称覆盖了。

方法3：避免`import *`（最佳实践）

最符合Python风格的做法是不要使用import *，而是采用显式导入：

from pyspark.sql import functions as F

所有Spark函数通过F.xxx调用，完全避免命名冲突，也不需要额外检测逻辑，这是PEP 8明确推荐的规范。

内容的提问来源于stack exchange，提问作者Don Vince

如何检测Python内置函数名称被其他模块导入覆盖？

1. 全局命名空间的查询位置问题 #

2. builtins的特殊机制 #

3. 其他类似的隐藏机制 #

符合Python风格的检测方法 #