python 内置了若干冻结模块，主要用于加速启动和支撑导入系统；虽无标准 python 接口直接列出全部冻结模块，但可通过 c api 或源码获取其名称——开发者应避免将自定义模块命名为这些内置名、标准库名、内置函数或关键字。
python 内置了若干冻结模块，主要用于加速启动和支撑导入系统；虽无标准 python 接口直接列出全部冻结模块，但可通过 c api 或源码获取其名称——开发者应避免将自定义模块命名为这些内置名、标准库名、内置函数或关键字。
在 Python 的模块导入机制中，“冻结模块”（frozen modules）是一类特殊模块：它们并非以 .py 源文件或 .pyc 字节码形式存在，而是被编译为 C 数组，静态嵌入到 Python 解释器可执行文件中（如 python.exe 或 libpython.so）。这类模块在解释器启动早期即可被直接加载，无需文件系统 I/O，因此对导入系统初始化（如 _frozen_importlib）、启动性能优化（如部分标准库模块）以及嵌入式/冻结分发场景至关重要。
值得注意的是，冻结模块 ≠ 可脱离 Python 运行的独立程序。后者是“应用冻结”（如 PyInstaller、cx_Freeze 所做的），而 CPython 自带的冻结模块是解释器自身的一部分，仅在 Python 启动时由内部机制自动注册并参与 import 流程。
常见冻结模块有哪些？
CPython 官方并未提供 sys.frozen_modules 这样的公开属性。截至 Python 3.13，冻结模块主要分为三类：
-
核心导入引导模块：如
_frozen_importlib（Python 3.3+ 后由_frozen_importlib_external替代，但其 bootstrap 部分仍冻结）、_frozen_importlib_external的底层支持模块； -
标准库预加载模块：自 Python 3.11 起，大量常用 stdlib 模块（如
io,abc,warnings,enum,pathlib,typing等）被主动冻结以提升启动速度； -
测试与基础设施模块：如
_testimportmultiple,_testcapi中的部分冻结组件。
完整列表需查阅 CPython 源码中的 Python/frozen.c，该文件按 Python 版本动态生成，是唯一权威来源。
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
如何在运行时探查冻结模块？（高级技巧，非生产推荐）
虽然 Python 不暴露稳定接口，但可通过 ctypes 访问底层 C API（仅限调试/学习，不建议用于生产环境）：
import ctypes
import itertools
class _frozen(ctypes.Structure):
_fields_ = [
('name', ctypes.c_char_p),
('code', ctypes.POINTER(ctypes.c_ubyte)),
('size', ctypes.c_int),
('is_package', ctypes.c_bool)
]
def list_frozen_modules():
frozen_names = []
# Python ≤ 3.10：使用全局 PyImport_FrozenModules
try:
arr = ctypes.POINTER(_frozen).in_dll(ctypes.pythonapi, 'PyImport_FrozenModules')
for i in itertools.count():
rec = arr[i]
if not rec.name:
break
frozen_names.append(rec.name.decode('utf-8'))
except ValueError:
pass # 未找到符号，跳过
# Python ≥ 3.11：尝试三个新符号
for sym_name in ['_PyImport_FrozenBootstrap', '_PyImport_FrozenStdlib', '_PyImport_FrozenTest']:
try:
arr = ctypes.POINTER(_frozen).in_dll(ctypes.pythonapi, sym_name)
for i in itertools.count():
rec = arr[i]
if not rec.name:
break
frozen_names.append(rec.name.decode('utf-8'))
except (ValueError, OSError):
continue
return sorted(set(frozen_names))
# 示例调用（结果因 Python 版本而异）
# print(list_frozen_modules()[:10]) # 如：['_abc', '_ast', '_bisect', '_blake2', '_codecs', ...]
⚠️ 重要提醒：
- 此方法依赖未公开、可能变更的 C 符号，Python 版本升级可能导致崩溃或返回空结果；
-
ctypes.pythonapi访问 CPython 内部结构属于“灰盒操作”，违反封装原则，不应出现在稳健项目中； - 实际开发中，完全无需关注冻结模块列表来规避命名冲突——真正需要回避的是：
- 所有
sys.builtin_module_names中的名称（如'sys','builtins'）； - 全部标准库模块名（参阅 Python Module Index）；
- 内置函数名（如
'len','print','open'）； - 关键字（
import keyword; keyword.kwlist）。
- 所有
✅ 最佳实践总结：
为避免 ImportError、意外覆盖或行为异常，请始终遵守命名守则：不重用任何出现在 help('modules')、dir(__builtins__)、keyword.kwlist 或官方文档索引页中的标识符作为模块/包名。冻结模块只是底层实现细节，而非开发者需主动管理的命名空间边界。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
