0

0

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

碧海醫心

碧海醫心

发布时间:2026-01-25 21:04:02

|

370人浏览过

|

来源于php中文网

原创

如何在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之模块学习 中文WORD版
Python之模块学习 中文WORD版

本文档主要讲述的是Python之模块学习;python是由一系列的模块组成的,每个模块就是一个py为后缀的文件,同时模块也是一个命名空间,从而避免了变量名称冲突的问题。模块我们就可以理解为lib库,如果需要使用某个模块中的函数或对象,则要导入这个模块才可以使用,除了系统默认的模块(内置函数)不需要导入外。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看

下载

立即学习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,即可精准、可靠地分别导入两个同名模块,彻底解决多版本模块隔离问题。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

775

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

684

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

768

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

719

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1445

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

571

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

751

2023.08.11

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

58

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 20.5万人学习

Django 教程
Django 教程

共28课时 | 3.5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号