1. python3中的模块和包

简单来讲，模块是一个包含Python定义和语句的文件，包是一种通过用“带点号的模块名”来构造 Python 模块命名空间的方法。

详细可以参考廖雪峰的：python教程-模块

本文以以下的项目结构，对python3的子包之间的调用进行探索：

使用的python版本：3.7.0

平台：win10

2. python的模块搜索路径

当一个名为 spam 的模块被导入的时候，解释器首先寻找具有该名称的内置模块。如果没有找到，然后解释器从 sys.path 变量给出的目录列表里寻找名为 spam.py 的文件。sys.path 初始有这些目录地址:

包含输入脚本的目录（或者未指定文件时的当前目录）；
PYTHONPATH （一个包含目录名称的列表，它和shell变量 PATH 有一样的语法）；
取决于安装的默认设置；

3. 调用子包与调用兄弟包

假如在main.py中调用pack.mod1.py中的函数func1，而func1又调用pack2.mod2.py中的func2函数，各个文件中的代码如下：

main.py:
import sys
print("file:{},sys.path:{}".format(__file__, sys.path))
from pack1 import mod1

if __name__ == "__main__":
    mod1.func1()


pack1/mod1.py:
from pack2 import mod2

def func1():
    print("this is pack1.mod1")
    mod2.func2()

pack2/mod2.py:
def func2():
    print("this is pack2.mod2")

进入test_mod目录，执行命令：

python main.py

输出：

file:main.py,sys.path:['D:\\1-Work\\python_src\\test_mod',

'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\python37.zip', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\DLLs', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\lib', 
'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37', 'C:\\Users\\xxx\\AppData\\Roaming\\Python\\Python37\\site-packages', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\lib\\site-packages']
this is pack1.mod1
this is pack2.mod2

可以看出sys.path中的第一个元素，就是main.py所在的目录，因为包pack1和pack2都在这个目录下，所以它们能够互相发现。

假如这个时候，你想单独调试一下pack1.mod1.func1函数，将mod1.py修改如下：

import sys
print("file:{},sys.path:{}".format(__file__, sys.path))

from pack2 import mod2

def func1():
    print("this is pack1.mod1")
    mod2.func2()

if __name__ == "__main__":
    func1()

进入pack1目录运行：

python mod1.py

输出如下：

file:mod1.py,sys.path:['D:\\1-Work\\python_src\\test_mod\\pack1',

'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\python37.zip', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\DLLs', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\lib', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37', 'C:\\Users\\xxx\\AppData\\Roaming\\Python\\Python37\\site-packages', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\lib\\site-packages']
Traceback (most recent call last):
  File "mod1.py", line 3, in <module>
    from pack2 import mod2
ModuleNotFoundError: No module named 'pack2'

发现sys.path的第一个路径已经是test_mod/pack1了，在这个目录下面解释器无法找到pack2这个包。

如果需要发现这个包，按照python搜索路径的规则，需要将test_mod这个目录加入到sys.path中，一般来说可以：

通过环境变量PYTHONPATH进行设置；
也可以将路径写入.pth文件，Python在遍历已知的库文件目录过程中，如果见到一个.pth 文件，就会将文件中所记录的路径加入到 sys.path 中；
最简单的是使用sys.path.append函数将路径加入。

使用最后一种办法，将pack1.mod1.py修改为：

import sys
sys.path.append("D:\\1-Work\\python_src\\test_mod")
print("file:{},sys.path:{}".format(__file__, sys.path))
from pack2 import mod2

def func1():
    print("this is pack1.mod1")
    mod2.func2()

if __name__ == "__main__":
    func1()

结果输出：

file:mod1.py,sys.path:['D:\\1-Work\\python_src\\test_mod\\pack1', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\python37.zip', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\DLLs', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\lib', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37', 'C:\\Users\\xxx\\AppData\\Roaming\\Python\\Python37\\site-packages', 'C:\\Users\\xxx\\AppData\\Local\\Programs\\Python\\Python37\\lib\\site-packages', 'D:\\1-Work\\python_src\\test_mod']

为什么使用绝对路径呢，因为如果使用相对路径的话，当前工作路径一变就不行了，不信在test_mod目录执行