Python在不同层级目录导入模块的方法与__init__.py详解

听雨眠
听雨眠
发布时间:2026-10-14 | 4人浏览过
原创

本文详细讲解Python中在不同层级目录下导入模块的方法,涵盖同级、子目录及上级目录的调用方式。重点介绍__init__.py文件在Python包中的作用,包括如何定义__all__变量实现批量导入,以及sys.path路径添加在Windows和Linux下的注意事项,帮助开发者解决模块导入错误问题。

Python模块导入概述

Python在不同层级目录导入模块的实现方法

在使用Python进行程序开发时,经常需要调用位于不同目录下的模块或函数。本文针对常见的模块调用场景,详细讲解导入模块的具体方法。

同级目录下的模块调用

1. 同级目录下的调用

目录结构如下:


– src 
|– mod1.py 
|– test1.py

若在程序test1.py中导入模块mod1,则直接使用import mod1或from mod1 import *。

子目录模块的导入方法

2. 调用子目录下的模块


*import mod1*或from mod1 import *;

目录结构如下:

目录结构如下:


– src 
|– mod1.py 
|– lib 
| |– mod2.py 
|– test1.py

这时,如果想在程序test1.py中导入模块mod2.py,可以在lib文件夹中建立空文件__init__.py。

新的目录结构如下:


– src 
|– mod1.py 
|– lib 
| |–__init__.py 
| |– mod2.py 
|– test1.py

然后使用:


from lib.mod2 import *或import lib.mod2.

上级目录模块的调用技巧

3. 调用上级目录下的文件

目录结构如下:


– src 
|– mod1.py 
|– lib 
| |– mod2.py 
|– sub 
| |– test2.py

这里想要实现test2.py调用mod1.py和mod2.py,做法是我们先跳到src目录下面,直接可以调用mod1,然后在lib上当下建一个空文件__init__.py,就可以像第二步调用子目录下的模块一样,通过import lib.mod2进行调用了。具体代码如下:


import sys
sys.path.append('C:\\test\\A\\C')
import mod1
import lib.mod2

需要注意的一点是:sys.path添加目录时注意是在windows还是在Linux下,windows下需要‘\\'否则会出错。

__init__.py文件的作用与__all__变量

补充__init__.py

在python模块的每一个包中,都有一个__init__.py文件(这个文件定义了包的属性和方法)然后是一些模块文件和子目录,假如子目录中也有__init__.py 那么它就是这个包的子包了。当你将一个包作为模块导入(比如从 xml 导入 dom )的时候,实际上导入了它的__init__.py 文件。

一个包是一个带有特殊文件 __init__.py 的目录。__init__.py 文件定义了包的属性和方法。其实它可以什么也不定义;可以只是一个空文件,但是必须存在。如果 __init__.py 不存在,这个目录就仅仅是一个目录,而不是一个包,它就不能被导入或者包含其它的模块和嵌套包。

__init__.py 中还有一个重要的变量,叫做__all__。

如果此时目录如下


– src 
|– mod1.py 
|– lib 
| |– mod2.py 
| |– mod3.py 
| |– sub 
| |– | |– mod3.py

我们有时会使出一招“全部导入”,也就是这样:


from lib import *

这时 import 就会把注册在包__init__.py 文件中 __all__ 列表中的子模块和子包导入到当前作用域中来。比如:


#文件__init__.py

__all__ = ["mod2", "mod3", "sub"]

以上这篇Python在不同目录下导入模块的实现方法就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持本站。

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表