| 語句 | 動作 | 命名空間影響 | 典型用法 |
import module | 載入模組,建立模組物件,綁定變數 module | 引入模組名稱,需 module.name 存取 | 標準、推薦、避免衝突 |
from module import name | 載入模組,將 name 綁定到當前命名空間 | 直接引入名稱,可直接用 name | 常用函式、類別、常數 |
from module import * | 匯入模組 __all__ 定義的所有公開名稱 | 大量汙染命名空間 | ❌ 禁止用於生產代碼 |
執行機制:模組只載入一次
# sys.modules 是模組快取字典
import sys
print('json' in sys.modules) # False
import json
print('json' in sys.modules) # True
import json # 直接返回快取,不重複執行模組代碼
實際範例對比
# === import module ===
import sys
print(sys.argv[0]) # 需前綴 sys.
print(sys.path)
# === from ... import ===
from sys import argv, path # 只引入需要的名稱
print(argv[0]) # 直接使用
print(path)
# === 別名 (避免衝突) ===
import numpy as np
import pandas as pd
from math import sqrt as math_sqrt
from cmath import sqrt as cm_sqrt # 同名函式區分
# === 相對匯入 (包內部) ===
# 當前包結構:
# mypkg/
# __init__.py
# core.py
# utils/
# __init__.py
# helpers.py
# 在 core.py 中:
from . import helpers # 同層級模組
from .utils import helpers # 子包模組
from .. import sibling_pkg # 父包 (僅在包內有效)
# 禁止:from ... import ... (超出頂層包)
命名空間汙染風險示範
# 危險範例
from math import *
from numpy import *
# 現在 sqrt 到底是 math.sqrt 還是 numpy.sqrt?
# 後匯入者覆蓋前者,行為差異巨大 (標量 vs 陣列)
result = sqrt(4) # 不可預期!
效能微差異
import timeit
# import module: 每次存取需兩次字典查找 (globals['sys'] → sys.modules['sys'] → sys.argv)
t1 = timeit.timeit('sys.argv', setup='import sys', number=10_000_000)
# from import: 一次字典查找 (globals['argv'])
t2 = timeit.timeit('argv', setup='from sys import argv', number=10_000_000)
print(f'import module: {t1:.3f}s')
print(f'from import: {t2:.3f}s')
# 差異極微小 (納秒級),不可作為選擇依據
循環匯入:成因與解決
# a.py
from b import func_b
def func_a(): return "a"
# b.py
from a import func_a
def func_b(): return "b"
# 執行 python a.py → ImportError: cannot import name 'func_a' from partially initialized module 'a'
解決策略
- 重構:提取共同依賴至第三個模組
- 延遲匯入:在函數內部
import 而非模組頂層
- 介面抽離:定義抽象基類/Protocol,打破具體依賴
- 合併模組:若緊密耦合,合併為單一模組
最佳實踐清單 (PEP 8 + 實戰經驗)
- 頂層統一用
import module,清晰顯示依賴來源
- 頻繁使用的函式/類別:
from module import ClassName, function_name
- 名稱衝突時:用別名
import module as alias 或 from module import name as alias
- 絕對禁止
from module import *:破壞靜態分析、IDE 智慧提示、除錯、重構
- 標準庫優先,第三方其次,本地最後
- 分組並排序:標準庫 → 第三方 → 本地,各群組字母序
- 避免相對匯入:除非在大型包內部,否則用絕對匯入
from mypkg.utils import helpers
- 型別檢查專用匯入:
from typing import TYPE_CHECKING; if TYPE_CHECKING: from heavy_module import HeavyClass
進階:匯入鉤子與動態匯入
import importlib
# 動態匯入 (插件系統、熱重載)
module_name = 'my_plugin'
mod = importlib.import_module(module_name)
func = getattr(mod, 'entry_point')
func()
# 重新載入 (開發時熱更新)
importlib.reload(mod)
# 檢查模組是否存在 (不載入)
spec = importlib.util.find_spec('optional_dependency')
if spec:
mod = importlib.util.module_from_spec(spec)
spec.loader.exec_module(mod)
總結
import module 是預設最佳選擇:命名空間乾淨、依賴關係明確、支援靜態分析。from module import name 適用於高頻使用的核心 API。理解模組載入機制、命名空間運作、循環匯入成因,能寫出更健壯、可維護的 Python 專案架構。
copyright ©
萬盛學電腦網 all rights reserved