Python模块导入语法指南：import与from...import用法区别

在 Python 中组织多文件代码或调用外部库时，import <module> 与 from <module> import <name> 是最基础的两种导入语法。它们的核心区别不在于模块是否被执行，而在于当前局部命名空间（Local Namespace）中所绑定的符号类型与调用方式：前者引入的是整个模块对象，调用时必须携带模块前缀；后者则直接将模块内部的具体变量、函数或类提取至当前作用域，无需前缀即可直接调用，但容易引发命名覆盖或循环导入问题。

一、命名空间与符号绑定机制：两者的本质差异

很多初学者误以为 from math import sqrt 只会加载并执行 sqrt 函数相关的代码，而 import math 会执行整个模块。在 Python 底层，这两种方式对模块文件的读取与执行是完全相同的：无论是哪种语法，Python 都会完整运行目标模块的顶层代码，并在全局字典 sys.modules 中缓存该模块对象。

两者的唯一本质区别发生在执行完成后的符号绑定（Binding）阶段：

• import math：在当前模块的局部命名空间中，创建了一个名为 math 的变量，该变量直接指向 sys.modules['math'] 对应的模块对象。要使用其内部功能，必须通过属性访问表达式 math.sqrt(9)。
• from math import sqrt：首先完整加载模块并缓存到 sys.modules['math']，然后在当前模块的局部命名空间中，直接创建一个名为 sqrt 的变量，使其指向模块内部的那个函数对象。当前命名空间内并不会存在 math 这个标识符。

图 1：import 与 from...import 在本地命名空间与模块内存对象之间的绑定关系对比

二、语法形式与典型使用示例

为了应对不同的工程规模和命名冲突场景，Python 提供了多种语法扩展形式：

1. 标准模块导入与别名

# 导入整个模块
import os
import json

current_dir = os.getcwd()
data = json.loads('{"version": 3.11}')

# 导入长模块名或冲突模块名时，使用 as 指定本地别名
import numpy as np
import pandas as pd

matrix = np.array([1, 2, 3])

2. 指定成员导入与成员别名

# 导入模块内的指定函数或类
from datetime import datetime, timezone
from math import pi, sqrt

now = datetime.now(timezone.utc)
radius = sqrt(100 / pi)

# 导入可能重名的成员时，使用 as 赋予明确的上下文名称
from logging import error as log_error
from asyncio import TimeoutError as AsyncTimeout

3. 星号通配符导入（Wildcard Import）及其隐患

# 不推荐的通配符语法
from os.path import *

三、底层模块导入的四步完整流程

了解导入语法的差异，离不开对 Python 内部执行流程的认知。当 Python 解析到一条 import 或 from...import 语句时，解析器会在内部严格按照以下 4 个阶段运行：

图 2：Python 模块导入的四步完整内部执行管线

四、循环导入（Circular Import）问题与差异分析

在稍大一些的工程项目中，不同模块互相调用是非常常见的场景，而循环导入（Circular Import）往往是导致 AttributeError: partially initialized module 报错的核心元凶。使用 import 与 from...import 会表现出截然不同的耐受性：

1. 故障场景重现

假设存在 service.py 与 models.py 互相调用的情况：

# 文件：service.py
from models import UserProfile  # 第一行：尝试从 models 导入 UserProfile

def register_user(username):
    return UserProfile(username)

# 文件：models.py
from service import register_user  # 尝试从尚未完成初始化的 service 导入

class UserProfile:
    def __init__(self, name):
        self.name = name

当主程序执行 import service 时，Python 立即加载 service.py，遇到第 1 行后挂起 service 转去执行 models.py。但在 models.py 第 1 行解析 from service import register_user 时，发现 service 正在初始化且尚未执行到定义 register_user 的代码行，于是直接抛出：
ImportError: cannot import name 'register_user' from partially initialized module 'service'。

2. 两种有效解法对比

• 方案一：改用 import module。只引入模块名称指针（如 import service），在调用函数内部使用 service.register_user()。由于属性解析被推迟到了函数运行期，此时两个模块都已经完成了顶层初始化，循环引用顺利解开。
• 方案二：延迟导入（Lazy Import）。将导入语句从模块顶层下移至具体使用该类的函数体内。

图 3：循环导入异常成因及基于模块级导入的解决方案

五、深度对比：变量重绑定与模块动态更新

除了命名空间和循环引用，另一个在生产中容易令人困惑的现象是不可变对象的跨模块重新赋值。观察以下代码：

# config.py
TIMEOUT = 30
SERVERS = ["10.0.0.1", "10.0.0.2"]

# client_a.py (使用 import config)
import config
def show_a():
    print(config.TIMEOUT, config.SERVERS)

# client_b.py (使用 from config import TIMEOUT, SERVERS)
from config import TIMEOUT, SERVERS
def show_b():
    print(TIMEOUT, SERVERS)

此时若在主程序中执行修改：

import config
import client_a
import client_b

# 重新赋值不可变对象
config.TIMEOUT = 60
# 原地修改可变对象
config.SERVERS.append("10.0.0.3")

client_a.show_a()  # 输出: 60 ['10.0.0.1', '10.0.0.2', '10.0.0.3']
client_b.show_b()  # 输出: 30 ['10.0.0.1', '10.0.0.2', '10.0.0.3']

原因剖析：client_b 中的 TIMEOUT 只是在导入时刻与模块中的 30 指向同一整数。当主程序对 config.TIMEOUT 重新赋值时，模块字典中的键指向了新的整数 60，而 client_b 本地变量 TIMEOUT 的指针并未更新；相反，client_a 始终通过 config.TIMEOUT 实时访问模块属性，因此能够读到最新状态。

六、特性对比与工程选型决策指南

在日常开发与团队规范中，应该如何选择具体的导入方式？下表从五个核心维度总结了两者的差异：

图 4：现代 Python 工程模块导入选型决策图

七、常见疑问与避坑建议

综上所述，import 与 from...import 并非互斥的替代品，而是服务于不同场景的工具：面对功能繁多的第三方大型库、易重名的标准库及共享配置文件，坚持使用 import module；而对于领域模型内高频、命名独一无二的类和关键工具函数，合理使用 from module import name 能让业务代码更加精炼易读。