Python import 引入不同路径模块的四种常见场景解析

Mason
Mason
发布时间:2026-10-13| 2人浏览过
原创

本文详细解析 Python 中 import 导入不同路径模块的四种典型场景。涵盖同目录、父目录、子目录及上级目录的导入方式,重点讲解 sys.path 环境变量配置与 __init__.py 文件的作用。通过具体代码示例,说明如何正确设置路径以确保模块被正确识别,适用于初学者解决模块找不到或导入失败的问题。

在 Python 中,导入包含子目录的模块操作相对直观,其核心在于确保 sys.path 列表中能够定位到模块文件所在的目录路径。

接下来将具体介绍几种常用的导入场景。

(1)主程序与模块文件位于同一目录下的情况:

假设存在如下目录结构:

``` `-- src |-- mod1.py `-- test1.py ```

当在 test1.py 中需要导入 mod1 模块时,可以直接使用 import mod1 或 from mod1 import * 语句进行导入。

(2)主程序所在目录是模块所在目录的父目录(或祖辈目录)的情况:

假设存在如下目录结构:

``` `-- src |-- mod1.py |-- mod2 | `-- mod2.py `-- test1.py ```

若在 test1.py 中导入 mod2 模块,必须在 mod2 文件夹内创建一个空的 __init__.py 文件(也可在该文件中定义并输出模块接口)。随后,使用 from mod2.mod2 import * 或 import mod2.mod2 语句进行导入。

(3)主程序需要导入上层目录中的模块,或导入其他平级目录下的模块的情况:

假设存在如下目录结构:

``` `-- src |-- mod1.py |-- mod2 | `-- mod2.py |-- sub | `-- test2.py `-- test1.py ```

若在 test2.py 中导入 mod1 和 mod2 模块,首先需要在 mod2 目录下建立 __init__.py 文件(操作同情况 2),而 src 目录下无需建立该文件。具体的调用方式如下所示:

以下所有程序的执行均需在文件所在的目录下进行。例如,执行 test2.py 时需先 cd sub,然后运行 python test2.py。

而执行 test1.py 时需先 cd src,然后运行 python test1.py。注意,这并不保证在 src 目录下直接执行 python sub/test2.py 能够成功。

```python import sys sys.path.append("..") import mod1 import mod2.mod2 ```

(4)从上述情况(3)可以看出,导入模块的关键在于根据 sys.path 环境变量的值,准确找到具体模块的路径。

本文仅介绍上述三种较为简单的情况。

以上关于 Python import 引入不同路径下模块的简要介绍就是分享给大家的全部内容,希望能对大家有所帮助,也希望大家多多支持本站。

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

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 算法库。