探寻Python导包路径机制

简介: 为什么我们`import os, improt sys, improt math`等模块,就可以成功导入其模块,而随便`import aaa`,就不行呢。那是因为`Python`的导包路径原因,让我们来康康`Python`的导包路径,是怎样的机制。

引言

为什么我们 import os, improt sys, improt math等模块,就可以成功导入其模块,而随便 import aaa,就不行呢。那是因为 Python的导包路径原因,让我们来康康 Python的导包路径,是怎样的机制。

<br/>

查看导包路径

可以通过内置sys模块来查看导包路径。

In [1]: import sys

In [2]: sys.path
Out[2]:
['D:\\Hui\\DevelopEnv\\Python\\Python379\\Scripts\\ipython.exe',
 'd:\\hui\\developenv\\python\\python379\\python37.zip',
 'd:\\hui\\developenv\\python\\python379\\DLLs',
 'd:\\hui\\developenv\\python\\python379\\lib',
 'd:\\hui\\developenv\\python\\python379',
 '',
 'd:\\hui\\developenv\\python\\python379\\lib\\site-packages',
 'd:\\hui\\developenv\\python\\python379\\lib\\site-packages\\IPython\\extensions',
 'C:\\Users\\Administrator\\.ipython']

In [3]:

<br/>

sys.path返回的是一个路径列表,其代表Python导包时搜素的路径

  • Python解释器sys.path里依次查找要导入的模块文件或包
  • '' 表示当前路径
  • sys.path列表中的路径的先后顺序代表了Python解释器在搜索模块时的先后顺序

<br/>

内置模块、包存放路径

os, sys, json等一些内置模块、包都存放在你下载 Python解释器时,其保存路径的 Lib目录

<br/>

存放路径以我个人的举例:

D:\Hui\DevelopEnv\Python\Python379\Lib

<br/>

Python内置模块、包的存放目录1

<br/>

Python内置模块、包的存放目录

<br/>

下载的第三方库存放路径

requestsipython这些自己下载的第三方库等都存放在 Lib下的 site-packages目录下

<br/>

存放路径以我个人举例

D:\Hui\DevelopEnv\Python\Python379\Lib\site-packages

<br/>

Python下载的第三方库存放位置

<br/>

然而导包路径sys.path就包含这两个路径

sys.path导包路径

<br/>

因此我们使用import osimport sysimport jsonimport requests等都可以找到相应的模块和包

<br/>

如果导入模块和包时在sys.path中没有搜索到相对应的模块,则会报如下错误

ModuleNotFoundError: No module named 'xxx'

<br/>

import aaa
---------------------------------------------------------------------------
ModuleNotFoundError                       Traceback (most recent call last)
<ipython-input-4-37ad1770aa41> in <module>
----> 1 import aaa

ModuleNotFoundError: No module named 'aaa'

其原理跟我们的电脑的环境变量-Path有点像。

我们可以在cmd窗口输入python可以打开python 交互解释器pip install xxx可以下载第三方库。都是因为系统环境变量-Path,有具体可执行文件的路径

系统环境变量Path

<br/>

python

<br/>

可执行的脚本

<br/>

追加新的导包路径

我们可以在程序运行时动态追加新的导包路径,代码如下
sys.path.append('D:\Hui\Code\Python\demo')        # 追加到末尾

sys.path.insert(0, 'D:\Hui\Code\Python\demo')   # 追加到开头位置,可以确保先搜索这个路径

<br/>

ipython 测验

追加导包路径到末尾

<br/>

追加导包路径至开头

<br/>

现在D:\Hui\Code\Python\demo目录下有一个aaa.py模块。

测试动态追加导包路径

<br/>

aaa.py模块内容如下

# aaa.py

def test():
    print('追加导包路径成功')

导包路径没追加D:\Hui\Code\Python\demo时,import aaa会报错

追加之后,在试试

追加导包路径测试结果

<br/>

追加导包路径之后就可以成功导入并使用了。

<br/>

Django项目追加导包路径

来康康导包路径的具体应用场景。

Django中我们通常把子应用模块统一放在apps包下,但在注册子应用的时候,该如何设置路径呢?

Django Apps

<br/>

我们在配置文件settings.pyordevelop.py中添加打印导包路径的代码

import sys
from pprint import pprint

pprint(sys.path)

其中pprintpretty print美化输出的意思,这样输出的列表不会在一行上。

然后运行Django程序查看导包路径结果

['C:\\Users\\Administrator\\Desktop\\meiduo_project\\meiduo_mall',
 'C:\\Users\\Administrator\\Desktop\\meiduo_project',
 'D:\\Hui\\DevelopTools\\PyCharm '
 '2020.2.3\\plugins\\python\\helpers\\pycharm_display',
 'd:\\hui\\developenv\\python\\python379\\python37.zip',
 'd:\\hui\\developenv\\python\\python379\\DLLs',
 'd:\\hui\\developenv\\python\\python379\\lib',
 'd:\\hui\\developenv\\python\\python379',
 'D:\\Hui\\VirtualEnv\\meiduo_mall',
 'D:\\Hui\\VirtualEnv\\meiduo_mall\\lib\\site-packages',
 'D:\\Hui\\DevelopTools\\PyCharm '
 '2020.2.3\\plugins\\python\\helpers\\pycharm_matplotlib_backend']

已知导包路径

  • meiduo_project/meiduo_mall

已知users应用所在目录

  • meiduo_project/meiduo_mall/meiduo_mall/apps/users

因此导入users 应用的路径可以写为:meiduo_mall/apps/users

知道导包路径我们就好在配置文件settings.pyordevelop.py中注册子应用

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    
    'meiduo_mall.apps.users',    # 注册用户模块
]

<br/>

是否可以将注册users应用做的更加简便?按照如下形式,直接以应用名users注册

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    
    'users',    # 注册用户模块
]

<br/>

分析:

  • 已知导包路径

    • meiduo_project/meiduo_mall
  • 已知users应用所在目录

    • meiduo_project/meiduo_mall/meiduo_mall/apps/users
  • 若要直接以应用名users注册

    • 需要一个导包路径:meiduo_project/meiduo_mall/meiduo_mall/apps

解决办法

  • 追加导包路径:meiduo_project/meiduo_mall/meiduo_mall/apps

<br/>

在配置文件settings.pyordevelop.py中追加导包路径

sys.path.insert(0, r'meiduo_project/meiduo_mall/meiduo_mall/apps/users')

Django项目追加导包路径

<br/>

在项目中一般不会写死路径,因此利用BASE_DIR来动态拼接路径

打印BASE_DIR内容如下

'C:\\Users\\Administrator\\Desktop\\meiduo_project\\meiduo_mall\\meiduo_mall'

其路径怎么得来的呢,我们来分析一下代码

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
  • 其中__file__是指向当前模块
  • os.path.abspath(__file__)是获取当前模块的绝对路径
  • os.path.dirname(os.path.abspath(__file__))则是根据当前模块路径获取其所在目录

因此:

os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

就是获取当前模块的所在目录的上一层目录。

Django项目BASE_DIR

<br/>

我这里的当前模块是develop.py,所在目录为settingssettings的上一层目录则是meiduo_mall

因此我们可以通过BASE_DIR动态拼接路径,来添加导包路径

# 追加子应用导包路径
sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))

注册子应用直接写应用名就可以了。

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 'meiduo_mall.apps.users'

    'users'
]

<br/>

导包路径的作用

通过查看导包路径,可以快速的知道项目中各个包该如何的导入。

接手项目时,可以尽快的适应项目导包的方式。

通过追加导包路径,可以简化某些目录复杂的导包方式。

<br/>

重新导入模块

模块被导入后,import module不能重新导入模块,重新导入需用imp下的reload

from imp import reload

<br/>

我们还是已上文提到的aaa.py模块举例

# aaa.py

def test():
    print('追加导包路径成功')

<br/>

ipython 测验

In [21]: import aaa

In [22]: aaa.test()
追加导包路径成功

In [23]:

这时不要关掉ipython然后修改aaa.py模块的如下

# aaa.py

def test():
    print('重新导入模块测试')

<br/>

然后回到ipython中测验

# 没修改前
In [21]: import aaa

In [22]: aaa.test()
追加导包路径成功

# 修改之后
In [23]: aaa.test()
追加导包路径成功

In [24]: import aaa

In [25]: aaa.test()
追加导包路径成功

In [26]:

其实aaa.py已经修改了,只是当前ipython交互器不知道,我们可以再开一个ipython交互器验证一下

In [3]: import sys

# 我的aaa.py 模块不在当前导包路径下,因此要动态追加一下
In [4]: sys.path.insert(0, 'D:\Hui\Code\Python\demo')

In [5]: import aaa

In [6]: aaa.test()
重新导入模块测试

In [7]:

<br/>

因此aaa模块被导入后,import aaa不能重新导入模块,重新导入需使用如下方式

# 没修改前
In [21]: import aaa

In [22]: aaa.test()
追加导包路径成功

# 修改之后
In [23]: aaa.test()
追加导包路径成功

In [24]: import aaa

In [25]: aaa.test()
追加导包路径成功

In [27]: from imp import reload

In [28]: reload(aaa)
Out[28]: <module 'aaa' from 'D:\\Hui\\Code\\Python\\demo\\aaa.py'>

In [29]: aaa.test()
重新导入模块测试

<br/>

✍ 码字不易,万水千山总是情,点赞再走行不行,还望各位大侠多多支持❤️

<br/>

公众号

新建文件夹X

大自然用数百亿年创造出我们现实世界,而程序员用几百年创造出一个完全不同的虚拟世界。我们用键盘敲出一砖一瓦,用大脑构建一切。人们把1000视为权威,我们反其道行之,捍卫1024的地位。我们不是键盘侠,我们只是平凡世界中不凡的缔造者 。
相关文章
|
22天前
|
计算机视觉 Windows Python
windows下使用python + opencv读取含有中文路径的图片 和 把图片数据保存到含有中文的路径下
在Windows系统中,直接使用`cv2.imread()`和`cv2.imwrite()`处理含中文路径的图像文件时会遇到问题。读取时会返回空数据,保存时则无法正确保存至目标目录。为解决这些问题,可以使用`cv2.imdecode()`结合`np.fromfile()`来读取图像,并使用`cv2.imencode()`结合`tofile()`方法来保存图像至含中文的路径。这种方法有效避免了路径编码问题,确保图像处理流程顺畅进行。
119 1
WK
|
21天前
|
Python
如何在Python中导入包
在 Python 中,包是一种组织代码的方式,通过包含 `__init__.py` 文件(在 Python 3.3 及以上版本可选)的目录实现。包内可以包含多个模块(`.py` 文件)和其他子包。导入包有多种方式:整体导入包、导入特定模块、导入特定函数或类、导入子包等。推荐的做法是明确指定导入内容以提高代码的可读性和可维护性。此外,确保包目录结构正确,并将其添加到 Python 的搜索路径中。对于分发包,使用 setuptools 和 pip 等工具更为便捷。
WK
113 66
WK
|
21天前
|
Python
如何在Python中创建包
在Python中创建包十分简便,主要涉及目录结构的设置及`__init__.py`文件的配置。虽然Python 3.3后空`__init__.py`文件不再强制要求,但在特定场景下保留它有助于保持兼容性或执行包初始化代码。创建包的具体步骤包括:构建目录结构、编写模块代码、(可选)编写初始化代码等。例如,可以创建一个名为`mypackage`的目录,其中包含`__init__.py`及多个模块文件如
WK
109 62
|
8天前
|
消息中间件 安全 Kafka
Python IPC机制全攻略:让进程间通信变得像呼吸一样自然
【9月更文挑战第12天】在编程领域,进程间通信(IPC)是连接独立执行单元的关键技术。Python凭借简洁的语法和丰富的库支持,提供了多种IPC方案。本文将对比探讨Python的IPC机制,包括管道与消息队列、套接字与共享内存。管道适用于简单场景,而消息队列更灵活,适合高并发环境。套接字广泛用于网络通信,共享内存则在本地高效传输数据。通过示例代码展示`multiprocessing.Queue`的使用,帮助读者理解IPC的实际应用。希望本文能让你更熟练地选择和运用IPC机制。
31 10
|
18天前
|
机器学习/深度学习 数据采集 TensorFlow
使用Python实现智能物流路径优化
使用Python实现智能物流路径优化
38 1
WK
|
22天前
|
开发者 Python
Python中的包是什么?
在Python中,包是一种组织模块的方式,用于实现代码重用和模块化。通过包含`__init__.py`文件的目录定义包,形成树状结构,便于管理大型项目。包提高了代码的可读性和可维护性,允许重用现有代码,并避免模块名冲突。使用点操作符导入包中的模块,`__init__.py`可在包导入时执行初始化代码。从Python 3.3起,还可使用命名空间包来组织模块。掌握包的使用对大型Python项目开发至关重要。
WK
17 5
WK
|
22天前
|
开发工具 git Python
如何在Python中创建包?
在Python中创建包十分简便,主要步骤包括:创建目录(如 `mypackage`),并根据需求添加空的或含初始化代码的 `__init__.py` 文件;接着在该目录下添加 `.py` 文件作为模块;如有需要,可以进一步创建子包以形成层次结构。创建完成后,即可在其他脚本中导入并使用这些包。为避免名称冲突,请选择独特的包名,并考虑使用版本控制系统(如Git)管理代码变更。对于需分发的包,还应准备 `setup.py` 文件以方便构建与发布。
WK
18 3
|
25天前
|
项目管理 数据安全/隐私保护 Python
使用poetry来更优雅的管理 python 包
Poetry 的优势在于它提供了一个统一的工具来处理 Python 项目的整个生命周期,从依赖管理到打包和发布。它的依赖解析器非常强大,能够有效地处理复杂的依赖关系。此外,Poetry 还提供了一个直观的命令行界面,使得项目管理变得更加简单。 对于团队协作和项目部署来说,Poetry 的依赖锁定功能(通过 poetry.lock 文件)特别有用,因为它确保了所有环境中使用相同版本的依赖。
|
26天前
|
Python
【Azure 应用服务】如何为Web Jobs 安装Python包呢?
【Azure 应用服务】如何为Web Jobs 安装Python包呢?
【Azure 应用服务】如何为Web Jobs 安装Python包呢?