Python 3 入门手札（13）import 模块

Import 会将 python 代码从另一个文件中转移到当前的程序中。这些代码包括变量、函式、类别、模块及套件。

模块（module）

模块基本上就是一般的程序文件（.py）。在模块中可以定义各种变量、函式或类别。例如，我们自己写了很多函式，就可以将之储存到模块中，等需要时再汇入使用。

套件（package）

如果功能较多或较复杂，则可以将之分门别类储存到多个模块中，然后将这些模块存放在一个文件夹里，这个文件夹就称为套件。

在套件中可以包含多个模块，而且必须有一个名为 _ _init _ _.py 的模块，里面可以有程序或是空的。另外套件也可以是巢状的，也就是套件中还有子套件。

Import xxx

在使用 import xxx 时，其实就是将 xxx 汇入到程序中使用，因此程序中会多出一个 xxx 对象可以使用。xxx 可以是变量、函式、类别、模块或套件。

1. 如果 xxx 是变量、函式或类别，那么就可以直接使用。

2. 如果 xxx 是模块，则会将该模块中所有定义的变量、函式、类别等，都加到 xxx 对象的名称空间中，因此就可以用 xxx.yyy 的写法来存取模块中的 yyy （变量、函式或类别）了。

3. 如果 xxx 是套件，则和汇入模块类似，但汇入的是套件中的 _ _ init_ _.py 模块。

Python 在执行 import xxx 时，会先在目前程序所在的文件夹中寻找 xxx，若找不到则会到储存内部函数库及第三方套件的文件夹中寻找，若找不到则显示错误讯息。

如果 xxx 不是最上层的模块或套件，则要改用 from ppp import xxx 的写法，其中 ppp 是最上层的模块或套件（如果有多层则要用〝.〞来串接，例如 from ppp.qqq import xxx）会从 ppp 套件中的 qqq 模块（或子套件）来汇入 xxx 。

假设目前程序所在的文件夹中有一个 mdu.py，其中内容如下：

# mdu.py

var = 1
fun()

那么底下用法是正确的：

在上表中，import mdu 是汇入整个 mdu 模块，如果要取用其中的函式 fun() 或变量 var，必须用 mdu.fun() 或 mdu.var。

至于 from mdu import fun 则是直接汇入 mdu 模块内的 fun，这时 fun 已在主模块内了，所以直接用 fun() 就可以了。同样的，from mdu import * 是从 mdu 内把所有对象都汇入，所以也是直接取用就可以了。

特别注意，import 模块时，不需要（也不可以）加 .py 扩展名。

如果目前的文件夹中有一个 pkg 套件（文件夹），其中内容有 _ _ init_ _.py 及 mdp.py。

# __init__.py

i_var
i_fun()

# mdp.py

var
fun()

那么底下用法是正确的：

有两点值得注意：

1. 在使用 import pkg 汇入套件时，其实只汇入套件中的 _ _ init_ _ 模块，而不是汇入套件中的其他模块。因此若要使用 pkg 的 mdp 模块，还必须另外用 from pkg import mdp 来汇入。

2. pkg 套件中 mdp 模块的 var、fun 名称和目前文件夹中 mdu 模块内的变量、函式名称重复了，不过因为它们所在的模块不同，因此并不会发生冲突。

如果同时将它们以原始名称汇入，就可能发生冲突了。例如：

from mdu import fun
from pkg.mdp import fun    # fun 名称发生冲突，后者会盖掉前者

这时可以用 as 来自定义汇入对象的名称，例如：

from mdu import fun
from pkg.mdp import fun as fun2 # 换个名称即可避免冲突

as 除了可以用来避免名称冲突外，也常用来缩短名称，以方便使用。例如：

from bs4 import Beautifulsoup as bs

就可用 bs 来取代长长的 BeautifulSoup 了。

Import 也可以同时汇入多个以逗号分隔的对象，并视需要分别以 as 自定义名称，例如：

from mdu import var as v, fun as f

参考：

《Python 技术者们实践！》施威铭研究室 着，旗标出版社