本系列随笔是本人的学习笔记，初学阶段难免会有理解不当之处，错误之处恳请指正。转载请注明出处：/itwhite/p/12302882.html。
目录
一、模块
指定导入的符号列表
模块查找的路径
在模块中插入测试代码
二、包
一、模块
所有 python 程序(.py文件)都可以作为一个模块，例如：
# foo.py
class Foo (object):
def __init__(self):
print("Created a Foo object")
def foo():
print("foo() is called")
FOO = 123
# 测试使用 foo 模块
>>> from foo import * # 导入 foo 模块，即 foo.py 中的内容(注：不会导入以下划线开头的符号)
>>> f = Foo() # 创建 Foo 的实例
Created a Foo object
>>> foo() # 调用 foo.py 中的 foo() 函数
foo() is called
>>> FOO # 直接使用 foo.py 中的全局变量 FOO
123
1. 指定导入的符号列表
从前面可以看到，通过 import * 语句会导入所有(不是以下划线开头的)符号，通过 __all__ 可以限定这种方式导入的符号，例如：
# foo.py
__all__ = ['Foo', 'foo'] # 只导出类名 Foo 和函数 foo() 的符号
class Foo (object):
def __init__(self):
print("Created a Foo object")
def foo():
print("foo() is called")
FOO = 123 # FOO 未被导出
# 测试使用 foo 模块
>>> from foo import * # 导入 foo 模块，即 foo.py 中的内容(注：不会导入以下划线开头的符号)
>>> f = Foo() # 创建 Foo 的实例
Created a Foo object
>>> foo() # 调用 foo.py 中的 foo() 函数
foo() is called
>>> FOO # FOO 未被导出
Traceback (most recent call last):
File "", line 1, in
NameError: name 'FOO' is not defined
>>> foo.FOO # 只能以模块名限定的形式访问
123
2. 模块查找的路径
通过 sys.path 可以查看和配置 python 解释器查找模块的路径列表：
>>> import sys
>>> sys.path # 搜索路径列表
['', 'C:\\Windows\\system32\\python27.zip', 'C:\\Python27\\DLLs',
'C:\\Python27\\lib', 'C:\\Python27\\lib\\plat-win', 'C:\\Python27\\lib\\lib-tk',
'C:\\Python27', 'C:\\Python27\\lib\\site-packages']
>>> sys.path.append('C:\\tmp\\python') # 追加一条搜索路径
另一种更常见的办法是通过 PYTHONPATH 环境变量去配置模块查找路径，例如：
export PYTHONPATH=$PYTHONPATH:~/python
3. 在模块中插入测试代码
有时候我们需要为模块写一些测试代码，直接写入模块文件中方便修改，但是不希望 import 时执行，可以通过当前模块名(__name__)来判断当前文件是作为主文件还是模块文件使用的，例如：
# add.py
def add(a, b):
return a + b
# 测试代码，当且仅当直接执行 add.py 才会执行(通过 import 导入 add.py 文件不会执行 if 中的内容)
if __name__ == '__main__':
print "Testing add()"
assert add(1, 2) == 3
print "Passed"
二、包
Python 中的“包”不需要在代码中声明，而是以文件夹的形式存在，只需要在某个文件夹中创建一个 init.py 文件(可以为空文件)即可，然后放入其中的模块文件就属于这个包，例如：
# 目录结构
.
+-- foo # 目录名
| +-- __init__.py # 空文件，python 解释器看到它会认为当前目录是一个包
| +-- bar.py # 模块文件
+-- test.py # 测试文件
# bar.py 文件内容
def qux():
print("qux() is called")
# test.py 文件内容
from foo.bar import qux
qux() # qux() is called
另外，“包”本身也可以作为一个模块，模块内容写入相应的 __init__.py 文件中即可，例如修改上面的文件内容：
# __init__.py 文件内容
def quz():
print("quz() is called")
# test.py 文件内容修改如下
from foo import quz
quz() # quz() is called
