Python / 系统课时

选择合适的 import 写法

选择合适的 import 写法

Python 提供多种导入方式,不同写法会影响代码可读性、名称来源和冲突风险。本篇通过对比 import、from import 和 as 别名,帮助你在项目中选择更清晰的模块引用方式。

学习目标

  • 理解不同 import 写法带来的名称变化
  • 掌握模块名、成员名和别名的使用场景
  • 能够避免导入冲突和命名混乱

使用 import 导入模块

最基础的方式是导入整个模块:

python
import math

result = math.sqrt(16)
print(result)

预期输出

text
4.0

这种方式会保留模块名称作为访问入口。看到 math.sqrt() 时,读者可以明确知道 sqrt 来自哪个模块。

在项目代码中,模块来源清晰通常比少写几个字符更重要,因此这是推荐的默认方式。

使用 from import 导入成员

如果只需要模块中的某个函数或变量,可以直接导入成员:

python
from math import sqrt

result = sqrt(25)
print(result)

预期输出

text
5.0

这种写法减少了调用长度,但名称来源不再明显。如果多个模块存在同名函数,容易产生覆盖问题。

例如:

python
from module_a import process
from module_b import process

后一次导入会覆盖前一次绑定的 process 名称。

使用 as 创建别名

当模块名称较长,或者存在名称冲突时,可以使用别名:

python
import datetime as dt

now = dt.datetime.now()
print(type(now).__name__)

预期输出

text
 datetime

别名应该保持明确含义。常见库有约定俗成的别名,例如 import numpy as np,但项目内部模块不建议随意缩写,否则会降低阅读成本。

三种写法的选择

写法 特点 适合场景
import module 来源清晰 大多数业务代码
from module import name 调用简短 名称唯一且稳定时
import module as alias 解决长名称或冲突 常用第三方库或冲突场景

避免名称污染

导入越多,当前文件名称空间中的名字越多,冲突概率也越高。

不推荐大量使用:

python
from module import *

这种写法会把模块中的大量名称直接复制到当前文件,难以判断变量来源,也可能覆盖已有名称。

实际项目中,优先使用模块导入;只有明确需要时才选择成员导入。

选择 import 写法的核心原则是让代码阅读者快速知道一个名称来自哪里。短小不是唯一目标,长期维护时的清晰性更重要。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

选择合适的 import 写法

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通