Python中sys.modules初始化与模块导入机制的相关疑问

嘿，你的观察很到位！确实像os这类模块在你的Python程序正式开始执行前就已经被预加载到sys.modules里了——这也是为什么你没法直接导入同名自定义文件的核心原因之一。先看看你贴的验证代码：

Python 3.13.1 (main, Dec  3 2024, 17:59:52) [Clang 16.0.0 (clang-1600.0.26.4)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> 'os' in sys.modules.keys()
True
>>> 're' in sys.modules.keys()
True

接下来逐个解答你的疑问：

疑问1：是不是因为os在程序启动时就已经在sys.modules里，所以同名自定义文件无法被导入？ #

完全正确！Python的导入逻辑第一步就是查sys.modules——这个字典是所有已加载模块的缓存池。只要模块名已经存在这里，import语句会直接返回缓存里的模块对象，根本不会去扫描本地的自定义文件。所以os提前占了坑，你的os.py自然没机会被导入。

疑问2：为什么删除sys.modules['os']后还是无法导入自定义的os.py？ #

这是因为你忽略了sys.path的优先级问题！当你删掉sys.modules里的os条目后，Python会重新触发导入流程，但它会按sys.path里的路径顺序去查找模块。而标准库的路径（比如你输出里的/opt/homebrew/Cellar/python@3.13/.../os.py）默认排在sys.path的靠前位置，比你的当前工作目录优先级高。

看你的测试代码：
自定义os.py：

# os.py
def fun():
    print("Custom os called!")

测试脚本test.py：

# test.py
import sys
del sys.modules['os']
import os
print("source file of the imported os -", os.__file__)
print(os.fun())

输出：

dhruv@MacBook-Air-2 test  % python3 test.py
source file of the imported os - /opt/homebrew/Cellar/python@3.13/3.13.1/Frameworks/Python.framework/Versions/3.13/lib/python3.13/os.py
Traceback (most recent call last):
  File "/Users/dhruv/Documents/test/test.py", line 12, in <module>
    print(os.fun())
       ^^^^^^
AttributeError: module 'os' has no attribute 'fun'

所以当你重新import os时，Python先找到了标准库的os模块，重新加载并把它放回sys.modules，自然就轮不到你的自定义文件了。

关于你总结的导入流程的补充 #

你总结的步骤已经抓了核心，但还有几个关键细节没覆盖：

• sys.path的顺序优先级：Python会严格按sys.path里的路径顺序查找模块，找到第一个匹配的就停止。标准库路径默认靠前，所以会优先被命中。
• 导入钩子（Import Hooks）：Python支持通过sys.meta_path和sys.path_hooks自定义导入逻辑，比如加载zip包里的模块、远程模块等。这些钩子会在扫描sys.path之前被触发。
• 模块加载的完整流程：找到模块文件后，Python会先编译成字节码（如果没有缓存的字节码文件），然后执行模块代码，把生成的模块对象存入sys.modules，后续导入直接用缓存。
• 隐性的依赖预加载：有些模块会被解释器核心或者其他预加载模块间接导入，哪怕你删了sys.modules里的条目，重新导入时可能又会被间接加载回来。

更准确的完整导入流程应该是这样的：

1. 先检查sys.modules缓存，存在则直接返回模块对象；
2. 遍历sys.meta_path里的导入钩子，尝试加载模块；
3. 如果钩子没找到，按顺序遍历sys.path里的路径，查找匹配的模块/包；
4. 找到后编译、执行模块代码，将模块对象存入sys.modules；
5. 返回模块对象。

备注：内容来源于stack exchange，提问作者Dhruv