在导入自定义的模块时,除了指定模块名之外,也需要指定目录,由于Python把目录称作包,因此,这类导入被称为包导入。包导入把计算机上的目录变成Python的命名空间,而目录中所包含的子目录和模块文件则对应命名空间中的属性。

Python已经导入的模块保存在一个内置的sys.modules字典中,以便记录哪些模块已经记录了。

一,模块搜索路径

导入过程首先需要定位导入文件的位置,也就是,告诉Python到何处去找到要导入的文件,因此,需要设置模块的搜索路径。在大多数情况下,Python会自动到默认的目录下去搜索模块;如果要在默认的目录之外导入模块,就需要知道Pyhon搜索模块路径的机制。

Python搜索模块的路径是由四部分构成的:程序的主目录、PATHONPATH目录、标准链接库目录和.pth文件的目录,这四部分的路径都存储在sys.path 列表中。

1,程序的主目录

主目录是指包含程序的顶层脚本的目录,Python首先会到主目录中搜索模块。

因为主目录总是第一个被搜索,如果模块完全处于主目录中,所有的导入都会自动完成,而不需要单独配置路径。

2,PATHONPATH目录

PATHONPATH目录是指PATHONPATH环境变量中配置的目录,是第二个被搜索的目录,Python会从左到右搜索PATHONPATH环境变量中设置的所有目录。

3,标准链接库目录

标准链接库目录是Python按照标准模块的目录,是在安装Python时自动创建的目录,通常不需要添加到PYTHONPATH目录中。

4,路径文件(.pth文件)

在模块搜索目录中,创建路径文件,后缀名为.pth,该文件每一行都是一个有效的目录。Python会读取路径文件中的内容,每行都作为一个有效的目录,加载到模块搜索路径列表中。简而言之,当路径文件存放到搜索路径中时,其作用和PYT)HONPATH环境变量的作用相同。

如果运行在Windows和Python3.0中,如果Python安装目录的顶层是C:\Python30,那么可以把自定义的路径文件 mypath.pth 放到该目录中。

也可以放到标准库所在位置的sitepackages子目录中(C:\Python30\Lib\sitepackages),来扩展模块的搜搜路径。

二,配置搜索路径

上述四种模块搜索路径,能够配置的选项只有PYTHONPATH环境变量和路径文件。例如,在Windows平台上,创建PYTHONPATH环境变量,设置变量的值,两个目录使用分号隔开:

C:\pycode\utilities;D:\pycode\package1

也可以创建一个名为 C:\Python30\pydirs.pth的文本文件,其内容如下所示:

C:\pycode\utilities
D:\pycode\package1

三,sys.path列表

如果想看模块搜索路径在机器上的实际配置,可以通过打印内置的sys.path列表来查看,这个列表是sys模块的path属性。

import sys
print(sys.path)

其实,sys.path是模块搜索的路径,Pytho在程序启动时进行配置,自动把顶级文件的主目录,PYTHONPATH环境变量中配置的目录,.pth文件中目录以及标准连接库目录加载到sys.path列表中,Python每次导入一个新的模块,都是从sys.path列表中查找搜索目录。

四,包导入基础

搜索路径是指Python搜索模块的路径前缀,在import 语句的路径上添加这些路径,以构成模块的绝对路径。通常把存储模块的根目录称作容器目录,记作dir0,容器目录dir0必须包含在搜搜路径中。

例如,在dir0目录下,存在dri1/dir2/mod.py模块,那么导入该模块需要设置搜索路径为dir0,并使用import  和路径导入该模块:

import dir1.dir2.mod
from dir1.dir2.mod import mod_fun

在import语句中列举目录名,以点号分隔,"."路径是对应于dir0内的目录,通过这个目录可以找到mod.py模块。

五,__init__.py包文件

如果选择使用包导入,就必须多遵循一条约束:包导入语句的路径中,每个目录内都必须有__init__.py文件,否则包导入失败。

对于目录结构 dir0/dri1/dir2/mod.py

import dir1.dir2.mod

必须遵守以下规则:

  • dir0是容器目录,不需要__init__.py文件,如果有,也会被忽略。
  • dir0必须列在模块搜索路径列表中,也就是说,dir0必须是主目录,或者列在PYTHONPATH环境变量中等。
  • dir1和dir2都必须包含一个__init__.py文件

__init__.py文件是当 import 第一次遍历一个包目录时所运行的文件,可以包含Python程序代码,也可以完全是空的。通常情况下,__init__.py文件扮演了包初始化的钩子,替目录产生模块命名空间以及使用目录导入时实现from*行为的角色。

1,包的初始化

Python在首先导入某个目录时,会自动执行该目录下的__init__.py文件中的所有程序代码。

2,模块命名空间的初始化

在包导入模型中,脚本内的目录路径,在导入后会变成真实的对象路径,即,为目录创建的模块对象提供了命名空间。

3,from *语句的行为

在__init__.py文件内使用__all__列表,来定义目录以from * 语句形式导入时,需要导出的属性清单。如果没有设置__all__,from *语句不会自动加载潜逃与该目录内的子模块,也就是说,只加载该目录下的__init__.py文件中罗列在__all__列表中的变量。

参考文档:

python引入导入自定义模块和外部文件

Python3导入自定义模块的3种方式

Python 学习 第十五篇:模块搜索路径和包导入的更多相关文章

  1. Python学习第十五篇——类继承和类实例化

    学习Python类时,我们明白了类的本质,以及所谓的面向对象编程思想强调的对事物本身的属性,我们对某一类事物进行描述——采用了很多方法,这些方法描述了类的属性(比如猫科动物的眼睛,四肢,是否哺乳类等等 ...

  2. Python学习日记(十五) collections模块

    在内置函数(dict.list.set.tuple)的基础上,collections模块还提供了几个其他的数据类型:Counter.deque.defaultdict.namedtuple和Order ...

  3. python-模块入门二(模块循环导入,区分python文件的两种用途,模块搜索路径,软件开发的目录规范)

    一.模块的循环导入问题 run.py # import m1 # 第一次导入 m1.py # 错误示范 ''' print('正在导入m1') from m2 import y #第一次导入m2 x= ...

  4. Python学习(十) —— 常用模块

    一.collections模块 在内置数据类型(dict.list.set.tuple)的基础上,collections模块还提供了几个额外的数据类型:Counter.deque.defaultdic ...

  5. python学习(十二)模块

    怎么一下子就来学了模块? 其实学了判断.循环.函数等知识就可以开始下水写程序了,不用在意其他的细节,等你用到的时候再回过头去看,此所谓囫囵吞枣学习法. 为啥学模块? 有点用的.或者有点规模的程序都是要 ...

  6. python 学习笔记十五 web框架

    python Web程序 众所周知,对于所有的Web应用,本质上其实就是一个socket服务端,用户的浏览器其实就是一个socket客户端. Python的WEB框架分为两类: 自己写socket,自 ...

  7. Python学习系列----第五章 模块

    5.1 如何引入模块 在Python中用关键字import来引入某个模块,比如要引用模块math,就可以在文件最开始的地方用import math来引入.在调用math模块中的函数时,必须这样引用: ...

  8. python学习笔记(五)——模块导入

    模块是一个包含所有你定义的函数和变量的文件,其后缀名是.py.模块可以被别的程序引入,以使用该模块中的函数等功能.这也是使用 python 标准库的方法. 1.模块的定义与分类 在python中模块实 ...

  9. python基础】——python添加模块搜索路径和包的导入

    方法一:函数添加1 import sys2 查看sys.path3 添加sys.path.append("c:\\") 方法二:修改环境变量w用户可以修改系统环境变量PYTHONP ...

随机推荐

  1. java基础(一)---数据类型&Math方法&强制转换

    数据类型及各种Math类方法 public class HelloWorld { public static void main(String args[]) { //各种数据类型的熟悉掌握,强制类型 ...

  2. Hibernate:查询

    本文内容 OID查询 对象导航查询 HQL查询 QBC查询 SQL查询 首发日期:2018-07-31 hibernate的查询方式: hibernate有很多查询方式 OID查询 对象导航查询: H ...

  3. Cas 服务器 JDBC身份校验

    之前的Cas服务器一直使用静态配置的账号密码进行身份认证,现在要让Cas服务器通过MySQL数据库中的用户信息进行身份认证. 一.添加数据库访问依赖 <!-- https://mvnreposi ...

  4. Java 关键字 速查表

    访问控制:private 私有的protected 受保护的public 公共的 类.方法和变量修饰符abstract 声明抽象class 类extends 扩允,继承final 终极,不可改变的im ...

  5. kali linux源大全

    输入leafpad /etc/apt/sources.list进入        #官方源 deb http://http.kali.org/kali kali main non-free contr ...

  6. TNS-12535: TNS:operation timed out

    AWS数据库云服务器出现了连接超时的错误,于是查看相关时段的alert日志,发现了如下的错误: **************************************************** ...

  7. c/c++ 多态的实现原理分析

    多态的实现原理分析 当类里有一个函数被声明成虚函数后,创建这个类的对象的时候,就会自动加入一个__vfptr的指针, __vfptr维护虚函数列表.如果有三个虚函数,则__vfptr指向的是第一个虚函 ...

  8. c/c++ 线性栈

    c/c++ 线性栈 线性栈 下面的代码实现了以下功能 函数 功能描述 push 压入 pop 弹出 show_list 打印 clear 移动top指针到栈底 destroy 释放所有内存空间 seq ...

  9. oracle 分组函数执行分析

    先上例了: select job as "JOB1", avg(sal) as "avg sal" from scott.emp group by " ...

  10. axios超时timeout拦截

    应用场景: 在网络请求中,可能不可避免的会遇到网络差或者请求超时的情况,这时候,如果你采用的技术是axios,那就可以通过设置拦截器捕获这个异常情况,并做出下一步处理. 代码实践: ① 设置拦截器,返 ...