在编写 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 npimport 不会自动执行安装。安装名称与导入名称也不一定相同,应以相应库的使用说明为准。
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 通过模块导入机制取得模块或对象,并绑定相应名字。两种导入形式主要区别在于名字的使用方式。应注意模块初始化、搜索路径与缓存,避免重名文件、星号导入和不必要的循环依赖。
![]()
“点赞有美意,赞赏是鼓励”
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.