应捕获 ModuleNotFoundError 而非 ImportError，仅处理包未安装；用 importlib.util.find_spec() 预检依赖；可选 import 必须延迟至函数内；区分开发与生产缺失场景，禁用自动 pip 安装。

捕获 ModuleNotFoundError 而不是泛用 ImportError

Python 3.6+ 中，包不存在时抛出的是 ModuleNotFoundError，它是 ImportError 的子类，但语义更明确。用宽泛的 ImportError 捕获会掩盖真正的导入逻辑错误（比如循环导入、语法错误），反而让调试变难。

实操建议：

立即学习“Python免费学习笔记（深入）”；

python-script-generator

快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。

下载

• 显式捕获 ModuleNotFoundError，只处理“包没装”这一种情况
• 对其他 ImportError 不做静默吞掉，让它冒泡便于定位问题
• 示例：

  try:
      import torch
  except ModuleNotFoundError:
      print("torch 未安装，跳过相关功能")
      torch = None

在运行时动态检查依赖而非仅靠 try/except

有些场景下，你希望提前知道缺失哪些包（比如启动时打印缺失依赖清单），或需要根据多个包的可用性组合启用不同后端。这时候光靠 try/except 不够灵活。

实操建议：

立即学习“Python免费学习笔记（深入）”；

• 用 importlib.util.find_spec() 预检：返回 None 表示包不可用，不触发 import 副作用
• 避免在 except 块里反复 import 同一个模块（可能重复报错或污染命名空间）
• 示例：

  if importlib.util.find_spec("pandas") is not None:
      import pandas as pd
  else:
      pd = None

区分开发期缺失和生产期缺失

用户运行你的脚本时缺包，和你在写代码时 IDE 报红缺包，是两类问题。前者要友好提示 + 降级；后者该由 requirements.txt 或 pyproject.toml 约束，不该靠运行时兜底。

实操建议：

立即学习“Python免费学习笔记（深入）”；

• 运行时缺失 → 提供清晰提示，比如 “请运行 pip install opencv-python”
• 开发期缺失 → 在 pyproject.toml 的 [project.optional-dependencies] 里声明可选依赖，让用户按需安装
• 不要在代码里自动执行 subprocess.run(["pip", "install", ...]) —— 权限、环境隔离、pip 版本差异都会出问题

避免在模块顶层无条件 import 可选包

把所有 import 写在文件开头，哪怕对应功能被 try/except 包裹，也会导致模块加载失败——Python 解析阶段就报错，根本进不到异常处理逻辑。

实操建议：

立即学习“Python免费学习笔记（深入）”；

• 可选依赖的 import 必须放在函数或方法内部，延迟到实际调用时才触发
• 如果必须在类定义中用到，改用字符串标注类型（from __future__ import annotations），并在方法体内 import
• 示例：

  def load_image(path):
      try:
          import cv2
          return cv2.imread(path)
      except ModuleNotFoundError:
          raise RuntimeError("cv2 未安装，请先 pip install opencv-python")

真正容易被忽略的是 import 位置和异常粒度的配合：一个 ModuleNotFoundError 捕获块里混着多个 import，结果某个包存在而另一个不存在，你就没法区分具体缺哪个。拆开、分层、延迟，比写得“看起来优雅”更重要。