如何在Python中从不同文件夹导入同名模块

本文介绍在无法修改pythonpath和文件名的前提下，通过相对路径导入同名模块（如needtotest.py）的可靠方法，重点讲解基于当前工作目录的包式导入技巧，并提供可直接运行的代码示例与关键注意事项。

在python项目中，当多个子目录下存在同名模块（例如 Proj/Task/Folder1/needtotest.py 和 Proj/Task/Folder2/needtotest.py），而你又受限于不能修改 PYTHONPATH 或重命名文件时，标准的 import needtotest 会因路径优先级始终加载后者（如 Folder2 中的版本）。此时，将父目录设为python包并使用显式相对导入路径是最稳健、最符合PEP 8规范的解决方案。

✅ 正确做法：以包结构方式导入（需确保包可识别）

首先，确认你的目录结构具备Python包特征——即每个参与导入的文件夹（Folder1、Folder2、Task）中都必须包含一个空的 __init__.py 文件（可以为空，但不可缺失）：

Proj/ └── Task/     ├── __init__.py          # 必须存在！使Task成为顶层包     ├── Folder1/     │   ├── __init__.py      # 必须存在！使Folder1成为子包     │   └── needtotest.py     └── Folder2/         ├── __init__.py      # 必须存在！使Folder2成为子包         └── needtotest.py

然后，关键前提：启动Python解释器时，当前工作目录（cwd）必须是 Proj/Task 或其父级（如 Proj）。可通过以下命令验证：

cd Proj/Task pwd  # 应输出类似 /path/to/Proj/Task

在此前提下，在 Proj/test/test.py 中即可安全导入：

立即学习“Python免费学习笔记（深入）”；

# Proj/test/test.py import sys import os  # 将 Proj/Task 添加到 sys.path（确保能解析 Task 为顶层包） sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'Task')))  # ✅ 正确导入：使用包路径，避免语法错误 from Folder1 import needtotest as needtotest_v1 from Folder2 import needtotest as needtotest_v2  # 调用各自模块中的函数（假设均定义了 lambda_handler） result1 = needtotest_v1.lambda_handler(event={}, context=None) result2 = needtotest_v2.lambda_handler(event={}, context=None)

⚠️ 注意：from Proj.Task.Folder2.needtotest import … 报 SyntaxError 的根本原因是 Proj.Task.Folder2.needtotest 是非法标识符（含点号），Python仅允许模块名作为合法标识符；正确写法是先让 Proj/Task 可见，再用 from Folder2 import needtotest。

? 替代方案：动态导入（无需修改工作目录）

若无法控制执行时的当前目录（如CI环境），可使用 importlib.util.spec_from_file_location 动态加载指定路径的模块：

import importlib.util import os  # 构造绝对路径 folder1_path = os.path.abspath("../Task/Folder1/needtotest.py") folder2_path = os.path.abspath("../Task/Folder2/needtotest.py")  # 动态导入 Folder1 版本 spec1 = importlib.util.spec_from_file_location("needtotest_v1", folder1_path) needtotest_v1 = importlib.util.module_from_spec(spec1) spec1.loader.exec_module(needtotest_v1)  # 动态导入 Folder2 版本 spec2 = importlib.util.spec_from_file_location("needtotest_v2", folder2_path) needtotest_v2 = importlib.util.module_from_spec(spec2) spec2.loader.exec_module(needtotest_v2)  # 使用 print(needtotest_v1.__file__)  # 确认来源 print(needtotest_v2.__file__)

? 总结与最佳实践

• 首选包式导入：添加 __init__.py + sys.path 注入 + from FolderX import module，语义清晰、调试友好、兼容ide。
• 避免 sys.append() 拼接路径失败：sys.path.append() 本身有效，但常见错误是路径拼写错误或未转为绝对路径（应使用 os.path.abspath()）。
• 严禁硬编码 from A.B.C import D 含点号的模块名：Python语法不支持，必须通过包结构或动态导入实现。
• 单元测试建议：在 test.py 开头统一处理路径逻辑，或使用 pytest 的 conftest.py 集中配置，提升可维护性。

通过以上方法，你无需改动现有文件名或全局 PYTHONPATH，即可精准、可靠地分别导入两个同名模块，彻底解决多版本模块隔离问题。