为何Python无法识别已导入目录中新添加的模块？

测试环境：Ubuntu 23.10 + Python 3.11.6

执行以下代码时，成功创建并导入module1，也能读取到module2.py的内容，但导入module2时抛出ModuleNotFoundError，且偶尔会成功运行，存在竞态条件：

import sys
from pathlib import Path
from shutil import rmtree

d = Path('/tmp/fleen')
try:
    rmtree(d)
except FileNotFoundError:
    pass
d.mkdir()
sys.path = [str(d)] + sys.path

(d / 'module1.py').write_text('x = 1')
import module1
assert module1.x == 1

(d / 'module2.py').write_text('x = 2')
print('file contains:', repr((d / 'module2.py').read_text()))
import module2
assert module2.x == 2

报错信息：

Traceback (most recent call last):
  File "example.py", line 16, in <module>
    import module2
ModuleNotFoundError: No module named 'module2'

核心原因 #

问题出在**Linux内核的目录项缓存（dentry cache）**与Python导入机制的交互：

• Python导入器查找模块时，需要读取目标目录的内容来匹配.py文件；
• Linux内核为优化IO性能，会缓存目录的条目信息，刚创建的module2.py的目录条目可能未同步到内核缓存，导致导入器无法识别该文件；
• 直接调用read_text能读取内容，是因为该操作通过文件路径直接访问，无需遍历目录列表，绕开了目录缓存限制；
• 偶尔成功的情况，是因为内核在导入操作前恰好刷新了目录缓存，这就是出现竞态条件的原因。

解决方法 #

有两种可靠的处理方式：

1. 使用Python官方缓存失效接口
   在导入module2前调用importlib.invalidate_caches()，强制导入器清除缓存并重新读取目录内容：

   import importlib
   
   # 创建module2.py的代码之后
   importlib.invalidate_caches()
   import module2
   

2. 触发Linux目录缓存刷新
   对目标目录调用os.stat()，内核会重新读取目录元数据并更新缓存：

   import os
   
   # 创建module2.py的代码之后
   os.stat(d)
   import module2
   

两种方法均能确保导入器识别到刚创建的模块文件，消除竞态条件。

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