在编写 Python 程序时,我们经常需要使用其他文件或库中提供的功能,例如数学计算、文件处理和数据分析。如果每次都复制相关代码,不仅容易重复劳动,也不便于维护。

import 语句用于导入模块,并在当前作用域中建立相应的名字绑定。理解模块导入,需要区分“查找和初始化模块”与“绑定名字”,也要注意导入形式、模块搜索位置以及重复导入时的行为。

一、认识模块与导入

1.1 什么是模块?

模块(Module)是组织 Python 代码的基本单位,可以包含变量、函数、类和其他可执行语句。

常见的模块是一个 .py 文件。例如,创建文件 calculation.py:

    

其他程序可以通过导入使用其中的功能。

不过,模块并不一定对应一个 .py 文件。Python 还支持内置模块和编译后的扩展模块等形式。

每个模块具有自己的命名空间(Namespace),用于保存模块中定义的名字及其绑定对象。

1.2 导入与安装的区别

导入是让当前程序使用已有模块;安装则是将第三方库及其相关文件放入相应的 Python 环境。

例如,math 属于标准库,通常可以直接导入:

print(math.sqrt(16))  # 4.0

第三方库则通常需要先安装,再导入。例如,在终端中安装 NumPy:

python -m pip install numpy

然后在 Python 代码中使用:

import numpy as np

import 不会自动执行安装。安装名称与导入名称也不一定相同,应以相应库的使用说明为准。

1.3 导入主要完成什么?

可以将导入过程理解为两个主要环节:

首先,查找指定模块,必要时创建并初始化模块对象;然后,按照导入形式,在当前作用域中绑定相应的名字。

如果模块已经成功加载并保存在缓存中,后续导入通常会复用已有模块对象。

因此,import 不只是把另一份文件中的代码复制到当前位置。

二、两种常见导入形式

2.1 使用 import 导入模块

基本形式为:

import 模块名

例如:

这里在当前作用域中绑定了名字 math,随后通过“模块名.属性名”访问其中的功能。

这种写法能够清楚地表明名字来自哪个模块,也有助于减少不同模块之间的名字冲突。

2.2 使用 from ... import 导入指定名字

基本形式为:

from 模块名 import 名字

例如:

这里直接在当前作用域中绑定 sqrt,因此使用时不再需要写 math.sqrt。

也可以一次导入多个名字:

在一个没有执行过其他导入的环境中,from math import sqrt 不会同时在当前作用域中绑定 math。若之后希望使用 math.pi,还需要另行导入 math。

2.3 两种形式的主要区别

import math 绑定模块名字,使用时通过模块访问属性;from math import sqrt 则直接绑定所指定的名字。

但 from math import sqrt 并不表示“只加载 sqrt 对应的一小段代码”。它仍然需要加载或取得 math 模块,再从中获取相应对象。

一般来说,希望突出功能来源时,可以使用 import;只使用少数几个名字且来源明确时,可以使用 from ... import。

三、使用 as 设置别名

3.1 为模块设置别名

使用 as 可以指定当前代码中使用的名字:

这里绑定的是 m。若此前没有导入 math,就不能仅凭这条语句直接使用 math.sqrt。

别名不会复制模块,也不会修改模块本身的名称,只是改变当前作用域中的访问名字。

对于常用第三方库,应尽量遵循通行约定,例如:

import matplotlib.pyplot as plt

统一的别名有助于读者快速识别代码所使用的库。

3.2 为导入的对象设置别名

也可以为具体名字设置别名:

print(square_root(16))  # 4.0

当两个模块提供同名函数时,别名可以避免后导入的名字覆盖前一个:

print(complex_sqrt(-9))  # 3j

别名应体现对象来源或用途,不宜为了缩短代码而使用难以理解的缩写。

四、导入自定义模块与包

4.1 导入同一目录中的模块

假设 calculation.py 与 main.py 位于同一目录。

calculation.py 的内容为:

    

main.py 的内容为:

在通常的脚本启动方式下,运行 main.py 时,Python 会将脚本所在目录纳入模块搜索路径,因此能够找到 calculation.py。

导入时不写 .py 后缀,也不使用文件路径分隔符:

import calculation

这里的 calculation 是模块名,不是完整文件名。

4.2 模块顶层代码会执行

首次导入普通 Python 源码模块时,模块的顶层代码会执行。

例如,calculation.py 的内容为:

    

执行 import calculation 时,会输出:

初始化 calculation 模块

函数定义语句也会执行,用于创建函数对象并绑定名字;函数体则要等到调用函数时才执行。

因此,不宜在可复用模块的顶层直接安排交互输入、大量计算或其他不希望在导入时发生的操作。

4.3 使用主程序判断

如果希望文件直接运行时执行演示代码,而被导入时不执行,可以使用主程序判断:

    

直接运行该文件时,模块中的特殊名字 __name__ 为 "__main__",演示代码会执行。

通过 import calculation 导入时,__name__ 通常为 "calculation",判断中的演示代码不会执行。其他未放入该条件中的顶层语句仍会正常执行。

4.4 使用包组织模块

包(Package)是一种能够包含子模块或子包的特殊模块,用于组织更大的代码结构。

例如,一个项目可以包含以下文件:

-- tools/calculation.py

其中,tools 是常规包,__init__.py 可以为空,也可以包含包的初始化代码。

在 main.py 中可以写:

也可以导入子模块:

导入 tools 并不意味着自动导入其中所有子模块,具体取决于包的初始化代码。Python 还支持没有 __init__.py 的命名空间包,但初学阶段可以先采用常规包结构。

4.5 绝对导入与相对导入

绝对导入(Absolute Import)写出从顶层包开始的导入路径:

from tools.calculation import add

包内部也可以使用相对导入(Relative Import)。例如,在 tools/report.py 中导入同包下的 calculation:

from .calculation import add

一个点(.)表示当前包,两个点(..)表示上一级包。

相对导入依赖包上下文,不能简单理解为“相对于当前工作目录”。

直接将包内文件作为普通脚本运行,可能因缺少包上下文而失败。可以从项目根目录使用模块方式启动:

python -m tools.report

五、模块搜索、缓存与名字绑定

5.1 Python 从哪里查找模块?

Python 通过导入机制查找模块。对于通常的顶层文件模块,标准库 中的 sys.path 是重要的搜索路径来源。

可以查看当前环境的搜索路径:

    

其中通常包含脚本所在目录或与启动方式有关的目录、标准库目录,以及第三方库所在的 site-packages 等位置。

具体内容受启动方式、虚拟环境和相关配置影响。Python 不会自动搜索计算机中的所有文件夹。

包的子模块还会依据所属包的搜索路径查找,不能把所有导入都简化为“直接遍历 sys.path”。

5.2 重复导入通常不会重复初始化

Python 使用 sys.modules 保存已加载模块。

在同一个解释器进程中,对同一模块名重复执行普通导入,通常会复用缓存中的模块对象,不会再次执行其顶层代码:

因此,修改模块源文件后,仅再次执行 import,通常不会自动更新已经加载的模块。

学习和调试时,重新启动解释器是较直接的做法。importlib.reload 可以重新加载模块,但已有对象引用和模块状态可能使结果更复杂,不宜将其理解为完全恢复初始状态。

5.3 删除导入名字不等于卸载模块

执行:

删除的是当前作用域中的 math 绑定,模块通常仍保存在 sys.modules 中。

再次导入时,一般会复用缓存对象。del math 不会自动撤销模块初始化时产生的影响。

5.4 from 导入的名字不会自动跟随重新绑定

假设 settings.py 中定义:

limit = 10

另一个文件中执行:

from settings import limit 将当时取得的对象绑定到当前名字 limit。之后重新绑定 settings.limit,不会同步改变当前名字 limit。

如果双方引用的是同一个可变对象,修改对象内容则可能被双方看到。因此,仍要区分“重新绑定名字”与“修改对象”。

对于需要持续读取模块当前状态的代码,使用 settings.limit 这样的模块属性形式通常更清楚。

六、常见误用与注意事项

6.1 避免星号导入

下面的写法会导入模块规定的一组名字:

如果模块定义了 ,通常按其中列出的名字导入;如果没有,则通常导入不以下划线开头的名字。

星号(*)导入容易使名字来源不清楚,还可能覆盖当前已有名字。因此,普通程序中应优先使用明确的模块导入或名字列表。

对于包,星号导入也不等于自动搜索并导入包目录中的全部模块。

6.2 避免文件名与常用模块重名

不要随意将自己的文件命名为 random.py、json.py 或 numpy.py 等已有模块或库的名称。

当本地文件优先被找到时,程序可能导入自己的文件,而不是预期的模块,从而出现属性缺失或循环导入等问题。

对于具有对应文件的模块,可以检查其来源:

并非所有模块都具有 __file__ 属性,因此这不是适用于全部模块的通用检查方式。

6.3 区分常见导入错误

ModuleNotFoundError 通常表示找不到所需模块。可能是模块名拼写错误、第三方库未安装到当前环境,或搜索路径不包含相应位置。

ImportError 则还可能表示模块已找到,但无法导入指定名字,例如:

from math import missing_function

此外,模块初始化期间执行代码时,也可能引发 ValueError、RuntimeError 等其他异常。因此,错误出现在 import 语句处,不一定说明模块没有安装。

排查第三方库安装问题时,可以先确认当前解释器:

print(sys.executable)

应确保安装依赖与运行程序使用的是同一个 Python 环境。

6.4 注意循环导入

循环导入(Circular Import)是指模块之间形成相互导入的依赖,例如模块 A 导入模块 B,而模块 B 又导入模块 A。

循环导入并非一定失败,但如果某一方访问了另一方尚未初始化完成的名字,就可能报错。

通常应先调整模块职责,将共同使用的功能移入独立模块,减少相互依赖,而不是仅靠改变导入语句的位置掩盖结构问题。

6.5 合理安排导入位置

通常将导入语句放在文件开头,位于模块文档字符串之后,并按标准库、第三方库、自定义模块分组。

导入也可以放在函数内部:

    

此时,math 绑定在函数的局部作用域中。每次调用都会执行到导入语句,但模块通常会从缓存中取得。

局部导入可以用于延迟加载或特定条件下的依赖处理,不过不必将所有导入都移入函数。清楚表达模块依赖,通常更有利于阅读和维护。

小结

import 通过模块导入机制取得模块或对象,并绑定相应名字。两种导入形式主要区别在于名字的使用方式。应注意模块初始化、搜索路径与缓存,避免重名文件、星号导入和不必要的循环依赖。

打开网易新闻 查看精彩图片

“点赞有美意,赞赏是鼓励”