python 面向对象专题（22）：基础（13）模块和包

0 ⽬标

了解模块

导⼊模块

制作模块

__all__

包的使⽤⽅法

⼀. 模块

Python 模块(Module)，是⼀个 Python ⽂件，以 .py 结尾，包含了 Python 对象定义和Python语句。

模块能定义函数，类和变量，模块⾥也能包含可执⾏的代码。

1.1. 导⼊模块

1.1.1 导⼊模块的⽅式

import 模块名

from 模块名 import 功能名

from 模块名 import *

import 模块名 as 别名

from 模块名 import 功能名 as 别名

1.1.2 导⼊⽅式详解

1.1.2.1 import

语法

# 1. 导⼊模块
import 模块名
import 模块名1, 模块名2...
# 2. 调⽤功能
模块名.功能名()

体验

import math
print(math.sqrt(9)) # 3.0

1.1.2.2 from..import..

语法

from 模块名 import 功能1, 功能2, 功能3...

体验

from math import sqrt
print(sqrt(9))

1.1.2.3 from .. import *

语法

from 模块名 import *

体验

from math import *
print(sqrt(9))

1.1.2.4 as定义别名

语法

# 模块定义别名
import 模块名 as 别名
# 功能定义别名
from 模块名 import 功能 as 别名
12345

体验

# 模块别名
import time as tt
tt.sleep(2)
print('hello')
# 功能别名
from time import sleep as sl
sl(2)
print('hello')

1.2. 制作模块

在Python中，每个Python⽂件都可以作为⼀个模块，模块的名字就是⽂件的名字。也就是说⾃定义模

块名必须要符合标识符命名规则。

1.2.1 定义模块

新建⼀个Python⽂件，命名为 my_module1.py ，并定义 testA 函数。

def testA(a, b):
     print(a + b)

1.2.2 测试模块

在实际开中，当⼀个开发⼈员编写完⼀个模块后，为了让模块能够在项⽬中达到想要的效果，这个开发⼈员会⾃⾏在py⽂件中添加⼀些测试信息.，例如，在 my_module1.py ⽂件中添加测试代码。

def testA(a, b):
     print(a + b)
testA(1, 1)

此时，⽆论是当前⽂件，还是其他已经导⼊了该模块的⽂件，在运⾏的时候都会⾃动执⾏ testA 函数的

调⽤。

解决办法如下：

def testA(a, b):
     print(a + b)
# 只在当前⽂件中调⽤该函数，其他导⼊的⽂件内不符合该条件，则不执⾏testA函数调⽤
if __name__ == '__main__':
     testA(1, 1)

1.2.3 调⽤模块

import my_module1
my_module1.testA(1, 1)

1.2.4 注意事项

如果使⽤ from .. import .. 或 from .. import * 导⼊多个模块的时候，且模块内有同名功能。当调

⽤这个同名功能的时候，调⽤到的是后⾯导⼊的模块的功能。

# 模块1代码
def my_test(a, b):
     print(a + b)
# 模块2代码
def my_test(a, b):
     print(a - b)
 
# 导⼊模块和调⽤功能代码
from my_module1 import my_test
from my_module2 import my_test
# my_test函数是模块2中的函数
my_test(1, 1)

1.3. 模块定位顺序

当导⼊⼀个模块，Python解析器对模块位置的搜索顺序是：

1. 当前⽬录

2. 如果不在当前⽬录，Python则搜索在shell变量PYTHONPATH下的每个⽬录。

3. 如果都找不到，Python会察看默认路径。UNIX下，默认路径⼀般为/usr/local/lib/python/

模块搜索路径存储在system模块的sys.path变量中。变量⾥包含当前⽬录，PYTHONPATH和由安装过

程决定的默认⽬录。

注意

⾃⼰的⽂件名不要和已有模块名重复，否则导致模块功能⽆法使⽤

使⽤from 模块名 import 功能 的时候，如果功能名字重复，调⽤到的是最后定义或导⼊的功

能。

1.4. __all__

__all__

如果⼀个模块⽂件中有 __all__ 变量，当使⽤ from xxx import * 导⼊时，只能导⼊这个列表中的元

素。

my_module1模块代码

__all__ = ['testA']

def testA():
     print('testA')
def testB():
     print('testB')

导⼊模块的⽂件代码

from my_module1 import *
testA()
testB()

⼆. 包

包将有联系的模块组织在⼀起，即放到同⼀个⽂件夹下，并且在这个⽂件夹创建⼀个名字

为 __init__.py ⽂件，那么这个⽂件夹就称之为包。

2.1 制作包

[New] — [Python Package] — 输⼊包名 — [OK] — 新建功能模块(有联系的模块)。

注意：新建包后，包内部会⾃动创建 __init__.py ⽂件，这个⽂件控制着包的导⼊⾏为。

2.1.1 快速体验

1. 新建包 mypackage

2. 新建包内模块： my_module1 和 my_module2

3. 模块内代码如下

# my_module1
print(1)
def info_print1():
     print('my_module1')

# my_module2
print(2)
def info_print2():
     print('my_module2')

2.2 导⼊包

2.2.1 ⽅法⼀

import 包名.模块名
包名.模块名.⽬标

2.2.1.1 体验

import my_package.my_module1
my_package.my_module1.info_print1()

2.2.2 ⽅法⼆

注意：必须在 __init__.py ⽂件中添加 __all__ = [] ，控制允许导⼊的模块列表。

from 包名 import *
模块名.⽬标

2.2.2.1 体验

from my_package import *
my_module1.info_print1()

三. 总结

导⼊模块⽅法

import 模块名
from 模块名 import ⽬标
from 模块名 import *

导⼊包

import 包名.模块名
from 包名 import *

__all__ = [] ：允许导⼊的模块或功能列表