Introduction to modules in the Python standard library series

Python的模块其实就是封装了一个或者多个功能的代码集合，以便于重用，模块可以是一个文件也可以是一个目录，目录的形式称作包。

模块分类

内置模块

内置模块可以理解成当你安装好python环境之后，直接可以使用import导入的就是内置模块，默认模块路径为：C:\Python35\lib，你也可以通过以下方式获取内置模块的路径：

 # 导入sys模块
 >>> import sys
 # 最后一个目录就是内置模块的路径
 >>> for n in sys.path:
 ...  print(n)
 ...

C:\Python35\lib\site-packages\pip-8.1.1-py3.5.egg
C:\Python35\python35.zip
C:\Python35\DLLs
C:\Python35\lib
C:\Python35
C:\Python35\lib\site-packages

第三方模块

第三方模块通常是开发者自己编写的模块，然后提交到python官方的库中，这样我们就可以下载安装使用了，默认安装目录为C:\Python35\lib\site-packages，

自定义模块

自己编写的模块

模块的导入方式

把一个模块当做成一个整体来进行导入

import sys

从一个模块中导入特定的变量或者是方法

from sys import path

调用的时候直接使用方法名path

>>> path
['', 'C:\\Python35\\lib\\site-packages\\pip-8.1.1-py3.5.egg', 'C:\\Python35\\python35.zip', 'C:\\Python35\\DLLs', 'C:\\Python35\\lib', 'C:\\Python35', 'C:\\Python35\\lib\\site-packages']

给导入的模块或者方法起一个别名

from sys import path as path_alias

调用的时候使用别名path_alias

>>> path_alias
['', 'C:\\Python35\\lib\\site-packages\\pip-8.1.1-py3.5.egg', 'C:\\Python35\\python35.zip', 'C:\\Python35\\DLLs', 'C:\\Python35\\lib', 'C:\\Python35', 'C:\\Python35\\lib\\site-packages']

添加默认的环境变量,当前生效

sys.path.append("PATH_NAME")

可以使用imp模块中的reload方法重新载入某个模块的方法，例如下面的实例：

$ cat simple.py 
#!/use/bin/env python

print('Hello, World!')
spam = 1

>>> import simple
Hello, World!
>>> simple.spam
1
>>> simple.spam += 1
>>> import simple
>>> simple.spam
2
>>> import imp
>>> imp.reload(simple)
Hello, World!
<module &#39;simple&#39; from &#39;/Users/ansheng/simple.py&#39;>
>>> simple.spam
1

模块导入顺序

1. 先在当前脚本目录寻找有没有与导入模块名称相同的文件，如果有就把这个文件当作模块导入（据不完全统计，这是个坑，测试re模块没有问题，但是测试sys模块就有问题了）

2. 查找模块路径下面有没有对应的模块名

3. 如果没有找到模块名就报错

import是如何工作的？

模块在被导入的时候会执行以下三个步骤：

1. 通过环境变量找到模块文件；

2. 编译成字节码文件，如果有字节码文件则导入字节码文件；

3. 执行模块中的代码来创建所定义的对象；

以上的三个步骤只有在程序运行时，模块被第一次导入时才会进行。如果已经导入了这个模块然后再次导入的时候会跳过上面的三个步骤，它会直接提取内存中已经加载的模块对象。Python已经导入的模块会保存在sys.modules字典中。

_X与__all__

在模块中的所有变量以_开头的都不会被from *所导入

$ cat simple.py 
#!/use/bin/env python

_spam1 = 1
spam2 = 1

>>> from simple import *
>>> dir()
# _spam1没有被导入
['__builtins__', '__doc__', '__name__', '__package__', 'spam2']

相反的__all__列表里面的变量则会被from *所导入，没有在__all__列表里面的变量则不会被导入

$ cat simple.py
#!/use/bin/env python

__all__ = ['spam2']

spam1 = 1
spam2 = 1

>>> from simple import *
>>> dir()
# spam1没有被导入
['__builtins__', '__doc__', '__name__', '__package__', 'spam2']

注意事项

据不完全统计，如果导入的模块的名称在当前目录下有这个文件，那么只会把当前目录下的这个文件当作模块，如下演示：

创建一个脚本文件，名称为scripts

[root@iZ28i253je0Z ~]# touch scripts.py

内容为

#!/usr/bin/env python
# _*_ coding:utf-8 _*_
# 导入一个模块re
import re
# 输出匹配到的字符串abc
print(re.match('\w+',"abc").group())

执行脚本

[root@iZ28i253je0Z ~]# python scripts.py 
# 把匹配到的结果abc输出出来
abc

创建一个.py文件，名称为re.py

[root@iZ28i253je0Z ~]# touch re.py

内容为

#!/usr/bin/env python
# _*_ coding:utf-8 _*_
# 输出内容modus
print("Hello Word")

再次执行scripts.py脚本

[root@iZ28i253je0Z ~]# python scripts.py 
# 先输出Hello Word
Hello Word
# 然后再报错没有match这个方法
Traceback (most recent call last):
  File "scripts.py", line 6, in <module>
    print(re.match('\w+',"abc").group())
AttributeError: 'module' object has no attribute 'match'

这是为什么呢？因为python把re.py当成模块re了，继续往下看：

更改scripts.py文件内容如下

[root@iZ28i253je0Z ~]# cat scripts.py 
#!/usr/bin/env python
# _*_ coding:utf-8 _*_

import re

re.py文件内容不变，然后我们在执行脚本scripts.py

[root@iZ28i253je0Z ~]# python scripts.py 
Hello Word

看到了吧，他会把re.py文件内的代码拿到scripts.py文件中去执行，这是个坑，最好别踩。

导入当前目录下子目录下的文件

[root@ansheng ~]# tree ./
./
├── modules
│   ├── __init__.py
│   ├── lib01.py
│   └── lib02.py
└── scripts.py

1 directory, 4 files
[root@ansheng ~]# cat scripts.py 
#!/usr/bin/env python
# 导入modules包下面的lib01模块
from modules import lib01
# 导入modules包下面的lib02模块
from modules import lib02
[root@ansheng ~]# cat modules/__init__.py 
#!/usr/bin/env python
[root@ansheng ~]# cat modules/lib01.py 
#!/usr/bin/env python
# lib01.py文件会输出"Hello lib01"
print("Hello lib01")
[root@ansheng ~]# cat modules/lib02.py  
#!/usr/bin/env python
# lib02.py文件会输出"Hello lib02"
print("Hello lib02")

执行结果

[root@ansheng ~]# python scripts.py
# 会执行modules/lib02.py与modules/lib01.py文件内容
Hello lib01
Hello lib02

包含目录下的文件时需要在目录下声明一个__init__.py文件，即使这个文件是空的也可以。

---

原文链接

Python的模块其实就是封装了一个或者多个功能的代码集合，以便于重用，模块可以是一个文件也可以是一个目录，目录的形式称作包。

模块分类

内置模块

内置模块可以理解成当你安装好python环境之后，直接可以使用import导入的就是内置模块，默认模块路径为：C:\Python35\lib，你也可以通过以下方式获取内置模块的路径：

 # 导入sys模块
 >>> import sys
 # 最后一个目录就是内置模块的路径
 >>> for n in sys.path:
 ...  print(n)
 ...

C:\Python35\lib\site-packages\pip-8.1.1-py3.5.egg
C:\Python35\python35.zip
C:\Python35\DLLs
C:\Python35\lib
C:\Python35
C:\Python35\lib\site-packages

第三方模块

第三方模块通常是开发者自己编写的模块，然后提交到python官方的库中，这样我们就可以下载安装使用了，默认安装目录为C:\Python35\lib\site-packages，

自定义模块

自己编写的模块

模块的导入方式

把一个模块当做成一个整体来进行导入

import sys

从一个模块中导入特定的变量或者是方法

from sys import path

调用的时候直接使用方法名path

>>> path
['', 'C:\\Python35\\lib\\site-packages\\pip-8.1.1-py3.5.egg', 'C:\\Python35\\python35.zip', 'C:\\Python35\\DLLs', 'C:\\Python35\\lib', 'C:\\Python35', 'C:\\Python35\\lib\\site-packages']

给导入的模块或者方法起一个别名

from sys import path as path_alias

调用的时候使用别名path_alias

>>> path_alias
['', 'C:\\Python35\\lib\\site-packages\\pip-8.1.1-py3.5.egg', 'C:\\Python35\\python35.zip', 'C:\\Python35\\DLLs', 'C:\\Python35\\lib', 'C:\\Python35', 'C:\\Python35\\lib\\site-packages']

添加默认的环境变量,当前生效

sys.path.append("PATH_NAME")

可以使用imp模块中的reload方法重新载入某个模块的方法，例如下面的实例：

$ cat simple.py 
#!/use/bin/env python

print('Hello, World!')
spam = 1

>>> import simple
Hello, World!
>>> simple.spam
1
>>> simple.spam += 1
>>> import simple
>>> simple.spam
2
>>> import imp
>>> imp.reload(simple)
Hello, World!
<module &#39;simple&#39; from &#39;/Users/ansheng/simple.py&#39;>
>>> simple.spam
1

模块导入顺序

1. 先在当前脚本目录寻找有没有与导入模块名称相同的文件，如果有就把这个文件当作模块导入（据不完全统计，这是个坑，测试re模块没有问题，但是测试sys模块就有问题了）

2. 查找模块路径下面有没有对应的模块名

3. 如果没有找到模块名就报错

import是如何工作的？

模块在被导入的时候会执行以下三个步骤：

1. 通过环境变量找到模块文件；

2. 编译成字节码文件，如果有字节码文件则导入字节码文件；

3. 执行模块中的代码来创建所定义的对象；

以上的三个步骤只有在程序运行时，模块被第一次导入时才会进行。如果已经导入了这个模块然后再次导入的时候会跳过上面的三个步骤，它会直接提取内存中已经加载的模块对象。Python已经导入的模块会保存在sys.modules字典中。

_X与__all__

在模块中的所有变量以_开头的都不会被from *所导入

$ cat simple.py 
#!/use/bin/env python

_spam1 = 1
spam2 = 1

>>> from simple import *
>>> dir()
# _spam1没有被导入
['__builtins__', '__doc__', '__name__', '__package__', 'spam2']

相反的__all__列表里面的变量则会被from *所导入，没有在__all__列表里面的变量则不会被导入

$ cat simple.py
#!/use/bin/env python

__all__ = ['spam2']

spam1 = 1
spam2 = 1

>>> from simple import *
>>> dir()
# spam1没有被导入
['__builtins__', '__doc__', '__name__', '__package__', 'spam2']

注意事项

据不完全统计，如果导入的模块的名称在当前目录下有这个文件，那么只会把当前目录下的这个文件当作模块，如下演示：

创建一个脚本文件，名称为scripts

[root@iZ28i253je0Z ~]# touch scripts.py

内容为

#!/usr/bin/env python
# _*_ coding:utf-8 _*_
# 导入一个模块re
import re
# 输出匹配到的字符串abc
print(re.match('\w+',"abc").group())

执行脚本

[root@iZ28i253je0Z ~]# python scripts.py 
# 把匹配到的结果abc输出出来
abc

创建一个.py文件，名称为re.py

[root@iZ28i253je0Z ~]# touch re.py

内容为

#!/usr/bin/env python
# _*_ coding:utf-8 _*_
# 输出内容modus
print("Hello Word")

再次执行scripts.py脚本

[root@iZ28i253je0Z ~]# python scripts.py 
# 先输出Hello Word
Hello Word
# 然后再报错没有match这个方法
Traceback (most recent call last):
  File "scripts.py", line 6, in <module>
    print(re.match('\w+',"abc").group())
AttributeError: 'module' object has no attribute 'match'

这是为什么呢？因为python把re.py当成模块re了，继续往下看：

更改scripts.py文件内容如下

[root@iZ28i253je0Z ~]# cat scripts.py 
#!/usr/bin/env python
# _*_ coding:utf-8 _*_

import re

re.py文件内容不变，然后我们在执行脚本scripts.py

[root@iZ28i253je0Z ~]# python scripts.py 
Hello Word

看到了吧，他会把re.py文件内的代码拿到scripts.py文件中去执行，这是个坑，最好别踩。

导入当前目录下子目录下的文件

[root@ansheng ~]# tree ./
./
├── modules
│   ├── __init__.py
│   ├── lib01.py
│   └── lib02.py
└── scripts.py

1 directory, 4 files
[root@ansheng ~]# cat scripts.py 
#!/usr/bin/env python
# 导入modules包下面的lib01模块
from modules import lib01
# 导入modules包下面的lib02模块
from modules import lib02
[root@ansheng ~]# cat modules/__init__.py 
#!/usr/bin/env python
[root@ansheng ~]# cat modules/lib01.py 
#!/usr/bin/env python
# lib01.py文件会输出"Hello lib01"
print("Hello lib01")
[root@ansheng ~]# cat modules/lib02.py  
#!/usr/bin/env python
# lib02.py文件会输出"Hello lib02"
print("Hello lib02")

执行结果

[root@ansheng ~]# python scripts.py
# 会执行modules/lib02.py与modules/lib01.py文件内容
Hello lib01
Hello lib02

包含目录下的文件时需要在目录下声明一个__init__.py文件，即使这个文件是空的也可以。

更多Python标准库系列之模块介绍相关文章请关注PHP中文网！