应捕获 ModuleNotFoundError 而非 ImportError，区分可选/必需依赖；用 globals() 动态注册模块标记；优先用 importlib.util.find_spec() 预检；发布时需声明 extras_require 并文档说明。
遇到 ModuleNotFoundError 时别直接 except ImportError
Python 3.6+ 中，ModuleNotFoundError 是 ImportError 的子类，但语义更精确——它只表示模块未安装或路径错误，而 ImportError 还可能掩盖语法错误、循环导入等真正需要报错的问题。直接捕获 ImportError 容易把本该失败的导入静默吞掉。
正确做法是显式捕获 ModuleNotFoundError，并明确区分「可选」和「必需」依赖：
- 可选模块：仅用于特定功能（如
pydantic做数据校验、rich做美化输出），缺失时降级处理 - 必需模块：核心逻辑依赖（如
requests在 HTTP 客户端中），缺失应立刻抛出带提示的异常
用 try/except + globals() 动态注册变量更安全
常见错误写法是把可选模块赋值给局部变量，然后在函数里反复判断是否存在——这容易因作用域或重命名导致误判。更稳的方式是在模块顶层用 try/except 尝试导入，并通过 globals() 统一注册一个标记变量和模块引用：
try:
import rich.console
RICH_AVAILABLE = True
console = rich.console.Console()
except ModuleNotFoundError:
RICH_AVAILABLE = False
console = None
这样后续代码只需检查 RICH_AVAILABLE，避免每次都要 if 'rich' in sys.modules 或重复 try/except。注意不要在 except 块里定义同名模块变量（比如 rich = None），否则类型检查器（如 mypy）会误判类型。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
importlib.util.find_spec() 适合做预检，不触发实际导入
如果只是想提前知道模块是否可用（比如在 CLI 入口做功能开关），用 importlib.util.find_spec() 比 try/except 更轻量——它只查路径和元数据，不执行模块代码，也不会触发副作用：
from importlib.util import find_spec
if find_spec("torch") is not None:
from .ml_utils import load_model
else:
load_model = None
这个方法特别适合在包的 __init__.py 中批量探测可选依赖，再统一导出条件性 API。但注意：find_spec() 对 namespace packages（如 google.cloud）支持有限，某些情况下会返回 None 即使模块实际可用。
发布时别漏掉 extras_require 和文档说明
即使代码里做了优雅降级，用户仍需知道哪些功能对应哪个依赖。在 setup.py 或 pyproject.toml 中声明 extras_require 是基本操作：
extras_require={
"validation": ["pydantic>=2.0"],
"cli": ["rich>=13.0", "click>=8.0"],
}
同时，在文档的「Installation」章节明确写出：pip install mypkg[validation,cli]。否则用户运行时报 ModuleNotFoundError 时，根本不知道要装什么——这时候再优雅的异常处理也救不了体验。
最常被忽略的是版本兼容性提示：比如 rich 13+ 用了新 API，旧版会崩溃，但 find_spec() 无法检测版本，必须靠 import 后检查 __version__ 或在 extras_require 中写死范围。
