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

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

本文详细讲解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 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。