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 三个点 python_自定义

在上表中,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()

那么底下用法是正确的:

import 三个点 python_python_02

有两点值得注意:

  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