Python导入模块时如何优先搜索本地目录而非同名标准库文件？

问题原因 #

该报错由Python模块导入优先级规则导致：

1. types属于Python标准库模块，解释器启动时就会被加载并缓存到sys.modules中，直接执行import types会优先命中缓存的标准库模块，不会搜索本地同名目录。
2. 若本地types目录下没有添加空的__init__.py文件，Python不会将其识别为合法的包，即使无命名冲突也无法正常导入。

解决方案 #

方案1：重命名本地包（最推荐，无副作用） #

直接修改本地types目录的名称，避开与标准库重名，比如改为my_types、custom_types等，修改后同步调整file1.py中的导入语句即可：

from my_types import file2

该方案完全规避了命名冲突，也不会影响其他依赖标准库types的代码运行，是生产环境的最优选择。

方案2：使用相对导入 #

如果你的项目按包结构组织，运行时工作目录为dir1与types的父目录，可以在file1.py中使用相对导入绕过全局模块名匹配：

from ..types import file2

注意：如果直接以脚本方式运行file1.py（而非通过上级包导入），相对导入会报错，该场景不适用。使用IDE运行时需要将dir1和types的父目录标记为源根（Sources Root），确保路径搜索正常。

方案3：调整模块缓存与搜索路径（仅临时测试可用，有严重副作用） #

如果必须保留types的命名，可以通过删除已缓存的标准库模块、强制优先搜索本地目录实现，在file1.py的导入语句前添加以下代码：

import sys
# 此处替换为你的项目根目录（即types目录所在的父目录）的绝对路径
sys.path.insert(0, "/path/to/your/project/root")
# 清除已缓存的标准库types模块
if "types" in sys.modules:
    del sys.modules["types"]

# 此时导入的就是本地types包下的file2
from types import file2

⚠️ 警告：该方案会导致后续所有import types的语句都命中本地包，若项目其他代码依赖标准库types会直接异常，禁止在生产环境使用。

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