一文搞懂Python中的import与目录层级

liftword1周前 (12-30)技术文章8

在Python开发中,合理地组织代码和正确地使用import语句是构建可维护、可扩展项目的关键。

在具体介绍之前,我们先理解两个概念:

包(package)和模块(module)

模块(module) 可以理解为一个.py扩展名的 python程序文件。

包(package) 就是包含一个或多个.py 程序的目录。

绝对导入与相对导入

绝对导入:从项目的根目录(或包含__init__.py的目录)开始,逐级指明模块或包的位置。

相对导入:使用点(.)表示当前包和父包,从而导入同级包或子包中的模块。相对导入仅在包内部有效,且当直接运行模块文件时可能会失败(因为此时没有包的概念)。

对于__init__.py文件,Python 3.3+版本以后,具有隐式命名空间包,可以不创建这个文件。当然为了使程序能够兼容Python 3.3和以前的环境,可以建一个空的__init__.py文件。

举例说明,假设我的程序目录结构如下:

my_project/  
│  
├── main.py       # 项目的入口文件  
├── package1/     # 第一个包  
│   ├── __init__.py  
│   ├── moduleA.py  
│   └── submodule/  
│       ├── __init__.py  
│       └── moduleB.py  
└── package2/     # 第二个包  
    ├── __init__.py  
    └── moduleC.py

在实际项目开发中,建议使用项目入口文件来包含模块,而不是在模块中去调用另一个模块。

上面目录结构中,my_project 是我的项目根目录,下面有两个包package1和package2

在main.py中调用moduleB:

from package1.submodule import moduleB  

在main.py中调用moduleA的方法funcA:

#直接导入整个模块
from package1  import moduleA  
# 使用时需要加前缀
moduleA.funcA()

或者

#从模块中导入特定内容
from package1.moduleA  import funcA
# 这时可以直接使用funcA
funcA()

上面例子都是在main.py中调用package1和package2中的模块

实际项目中入口程序可能在另外的目录,比如在my_project下面的app目录。

my_project/  
│  
├── main.py       # 项目的入口文件  
├── app/     #应用程序目录
│   ├── app.py  # 应用程序的主文件
├── package1/     # 第一个包  
│   ├── __init__.py  
│   ├── moduleA.py  
│   └── submodule/  
│       ├── __init__.py  
│       └── moduleB.py  
└── package2/     # 第二个包  
    ├── __init__.py  
    └── moduleC.py

这时候如果在app/app.py中调用moduleB.py或moduleC.py 情况就不一样了。

from package1.submodule import moduleB  

如果像上面这样使用,首先要需要确保项目目录my_project在Python环境变量PYTHONPATH中,Python解释器能够找到你的项目目录。

如果你是在pycharm等IDE中开发,项目根目录是my_project,因为IDE已经帮你正确设置了项目的工作目录,直接在app.py中运行应该不会有问题。但如果你是从终端,比如CMD下运行app.py,那么很可能会提示ModuleNotFoundError.

解决办法1,使用-m选项,运行命令为:

python -m my_project.app.app

另外一个办法就是使用sys.path.append

在app.py程序开头添加下面代码

import sys; 
sys.path.append('../'); 

这样就可以使程序在脱离IDE的情况下也能正常运行。

相关文章

掌握这些Python后缀,让你的编程之路更加顺利

想象一下,你正在玩一个大型的多人在线游戏,你的任务是建造一个强大的城堡,保护自己免受敌人的攻击。你需要收集各种资源,比如木材、石头和金属,然后将它们组合在一起,建造出你的城堡。这就像是编程中的代码编写...

Python处理文件的6个常用代码,使用频率很高,值得收藏

日常工作中,我们经常会遇到一些查找、存储文件的问题,比如文件合并、文件分解等,这些问题涉及到对文件进行操作处理。对此,Python的OS库提供了很多功能模块供使用,本文整理了其中6个使用频率很高的常用...

Python语言的12个基础知识点小结(python语言基础总结)

python编程中常用的12种基础知识总结:正则表达式替换,遍历目录方法,列表按列排序、去重、字典排序、字典、列表、字符串互转,时间对象操作,命令行参数解析(getopt),print 格式化输出,进...

文件后缀,也称为文件扩展名,用于标识文件的类型

文件后缀,也称为文件扩展名,用于标识文件的类型,帮助操作系统确定使用何种程序来打开文件。这里列举一些常见的文件后缀名及其所代表的文件类型:? 文本文件:? .txt:纯文本文件? .doc、.docx...

「Python教程」第5篇 Python程序结构

Python程序的基本单元是文件,每个文件就是独立的一个最小的Python程序。用Python IDLE创建文件下面的动图显示了如何使用Python IDLE在Python安装目录下创建一个test....

破解文件处理难题:用 Python 处理 .txt 文件的必学方法

引言:Python中,对.txt后缀的文件进行多种操作。以下是一些常见的操作及其示例代码:先让我们来学习一下文件的打开模式及其作用:读取整个文件:path =r'D:\file.txt'...