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

捕获 ModuleNotFoundError 而不是泛用 ImportError

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

实操建议：

提示词大师-python版

图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍

下载

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

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

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

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

实操建议：

• 用 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 约束，不该靠运行时兜底。

实操建议：

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

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

把所有 import 写在文件开头，哪怕对应功能被 try/except 包裹，也会导致模块加载失败——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，结果某个包存在而另一个不存在，你就没法区分具体缺哪个。拆开、分层、延迟，比写得“看起来优雅”更重要。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！