网易首页 > 网易号 > 正文 申请入驻

Python:import 语句与模块导入

0
分享至

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


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

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

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.

相关推荐
热点推荐
前10月全国税收收入增长6%,其中个税收入增长22.9%

前10月全国税收收入增长6%,其中个税收入增长22.9%

风向观察
2026-11-20 18:17:34
人事|孙珊任上海市规划和自然资源局局长

人事|孙珊任上海市规划和自然资源局局长

上观新闻
2026-11-20 19:23:37
邝港智供词炸裂!谭方骏喜欢的是他,曾与蔡天凤3人同睡一张床

邝港智供词炸裂!谭方骏喜欢的是他,曾与蔡天凤3人同睡一张床

社会日日鲜
2026-11-20 10:27:11
特朗普临走撂下句话,我越想越不对劲:这哪是夸中国,分明是报价

特朗普临走撂下句话,我越想越不对劲:这哪是夸中国,分明是报价

天光破云来
2026-11-20 13:12:25
TVB台庆:叶蒨文露半球狂凹造型,却被汪明荃的辣椒装抢了风头

TVB台庆:叶蒨文露半球狂凹造型,却被汪明荃的辣椒装抢了风头

手工制作阿歼
2026-11-20 16:14:33
陕西23岁女大学生,被黑人男友传染艾滋,事后称很爱他我不后悔

陕西23岁女大学生,被黑人男友传染艾滋,事后称很爱他我不后悔

妙妙奇思物语
2026-11-20 14:58:41
悲催!20多年倾尽60万培养的211毕业生遭裁员,河南老父亲发帖控诉,引发轩然大波

悲催!20多年倾尽60万培养的211毕业生遭裁员,河南老父亲发帖控诉,引发轩然大波

火山詩话
2026-11-20 09:53:44
万物新生(爱回收)2026年三季度财报:营收64.5亿元,同比增长25.3%

万物新生(爱回收)2026年三季度财报:营收64.5亿元,同比增长25.3%

市值Observation
2026-11-20 11:18:21
它是“菜中人参”,冬天遇到别手软,买10斤囤着,随吃随取特省事

它是“菜中人参”,冬天遇到别手软,买10斤囤着,随吃随取特省事

阿龙美食记
2026-11-19 11:00:12
全完了!黄仁勋多项“恶行”被美国媒体曝光,多名英伟达高管大爆黑料

全完了!黄仁勋多项“恶行”被美国媒体曝光,多名英伟达高管大爆黑料

可达鸭面面观
2026-11-19 21:51:59
现在一些国企总部,越来越像晚清朝廷了

现在一些国企总部,越来越像晚清朝廷了

职场资深秘书
2026-11-20 11:15:00
高市早苗APEC独坐角落扇扇子,引日本网民群嘲:是去丢人现眼的吗?

高市早苗APEC独坐角落扇扇子,引日本网民群嘲:是去丢人现眼的吗?

可达鸭面面观
2026-11-20 08:41:45
王毅:我刚刚在机场相继送别了特朗普总统和普京总统,所以让大家久等了,各位辛苦了,听得出,外长的嗓音有些沙哑,也非常辛苦

王毅:我刚刚在机场相继送别了特朗普总统和普京总统,所以让大家久等了,各位辛苦了,听得出,外长的嗓音有些沙哑,也非常辛苦

每日经济新闻
2026-11-20 09:59:35
沙特首都第一高楼遭袭:炮弹从天而降,金融区上空亮起火光,多个楼层和周边建筑受损,所有入口封闭、人员疏散

沙特首都第一高楼遭袭:炮弹从天而降,金融区上空亮起火光,多个楼层和周边建筑受损,所有入口封闭、人员疏散

极目新闻
2026-11-20 10:43:41
黄仁勋据称将创办新的半导体公司 或将筹资500亿美元用于创业

黄仁勋据称将创办新的半导体公司 或将筹资500亿美元用于创业

财联社
2026-11-20 16:09:05
江苏男子撞破妻子出轨,熟睡中被灌进水泥,真相让人后背发凉

江苏男子撞破妻子出轨,熟睡中被灌进水泥,真相让人后背发凉

夜话奇谭
2026-11-20 14:50:59
尾盘,A股突变,爆天量了!

尾盘,A股突变,爆天量了!

中国基金报
2026-11-20 15:53:51
巴萨再出梅西式天才?12岁童星52场狂轰145球 耐克1年前就已签下他

巴萨再出梅西式天才?12岁童星52场狂轰145球 耐克1年前就已签下他

风过乡
2026-11-20 08:54:48
特朗普在深圳没拉车窗帘,这个细节让美国特勤局集体沉默

特朗普在深圳没拉车窗帘,这个细节让美国特勤局集体沉默

歪歌社团
2026-11-20 07:01:47
回国了我才敢说:日本,是我去过的所有国家中,最被看轻的

回国了我才敢说:日本,是我去过的所有国家中,最被看轻的

瓦伦西亚月亮
2026-11-20 09:39:07
2026-11-20 19:52:49
MediaTea
MediaTea
专业的数字媒体、新媒体技术
2324文章数 85关注度
往期回顾 全部

科技要闻

Anthropic收涨17.1%,市值一度破2万亿美元

头条要闻

父亲看望在外读书女儿住招待所 遭同屋两男子半夜劫杀

头条要闻

父亲看望在外读书女儿住招待所 遭同屋两男子半夜劫杀

体育要闻

脚步未停!西班牙摩托车手赤脚徒步入境中国

娱乐要闻

官媒发文 官宣赵丽颖新身份,进步很大

财经要闻

最大回撤超37%,黄金崩盘了吗?

汽车要闻

35万级MPV的满配答案 享界V8正式上市售31.98万起

态度原创

教育
房产
本地
手机
军事航空

教育要闻

家里长期脏乱,其实是留给孩子昂贵的负担

房产要闻

黄埔商业规划曝光!科学城能级跃升,核心入场券已锁定

本地新闻

43年起落记忆倒计时,去厦门高崎领绝版登机牌!

手机要闻

史上最强阔直板!华为星芒OSTA O1 Pro星芒紫独占16+1T顶配版:8799元

军事要闻

沙特首都第一高楼遭袭:炮弹从天而降

无障碍浏览 进入关怀版