importlib.util.find_spec()是最轻量可靠的模块存在性检测方式，返回ModuleSpec表示存在、None表示未找到；importlib.metadata.version()安全获取已安装模块版本，需配合packaging.version.parse()进行语义化比较。
用 importlib.util.find_spec() 判断模块是否存在
这是最轻量、最可靠的方式，不触发模块实际导入，也不会因模块副作用或初始化失败而报错。适用于只想确认模块是否可被 Python 找到的场景。
常见错误是直接 import 后捕获 ImportError —— 有些模块在 __init__.py 里执行耗时操作或依赖缺失（比如 torch 检查 CUDA），会导致假性“不存在”或卡住。
-
importlib.util.find_spec("requests")返回ModuleSpec对象表示存在；返回None表示未安装或不在sys.path - 注意它不区分“未安装”和“路径没加对”，只反映当前 Python 解释器能否定位到该模块
- 对命名空间包（如
pkg_resources）可能返回None，即使已安装——因为这类包没有传统__file__
用 importlib.metadata.version() 获取已安装模块的版本号
Python 3.8+ 原生支持，无需额外依赖。比调用 pip show 更快、更稳定，且不受当前环境 pip 配置影响（比如使用了镜像源或自定义 index-url）。
容易踩的坑是误用 pkg_resources.get_distribution()：它在某些打包环境（如 PyInstaller、conda 的非 root 环境）下会抛 DistributionNotFound，而 importlib.metadata 更健壮。
立即学习“Python免费学习笔记（深入）”；
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
-
importlib.metadata.version("numpy")直接返回字符串如"1.26.4" - 模块未安装时抛
importlib.metadata.PackageNotFoundError，需显式捕获 - Python importlib_metadata 兼容包：
pip install importlib-metadata
用 pip show 命令行方式验证（适合调试和 CI 脚本）
当需要确认 pip 级别的安装状态（比如虚拟环境是否激活、是否全局安装 vs 用户安装），命令行比 Python API 更直观。尤其适合写 shell 脚本或 Makefile。
但不要在生产代码里用 subprocess.run(["pip", "show", "xxx"]) 来查版本——开子进程开销大，且受用户 PATH 和 pip 版本影响（旧版 pip 可能无 show）。
-
pip show requests输出含Version:、Location:、Requires:等字段 -
pip show nonexistent_module退出码为 1，stdout 为空，stderr 含WARNING: Package 'nonexistent_module' not found - 若使用 Poetry 或 Pipenv，应优先用其对应命令（如
poetry show requests），因为 pip 可能看不到它们管理的包
组合使用：安全检查模块存在性和版本兼容性
实际项目中常需判断“模块是否存在且版本 ≥ X.Y.Z”。单独用 find_spec 不知道版本，单独用 version() 会抛异常，必须组合处理。
最容易被忽略的是版本比较逻辑：不能直接用字符串比较（"2.0.0" > "10.0.0" 为 False），必须用 packaging.version.parse() 或 LooseVersion。
- 先
if importlib.util.find_spec("click"):快速排除未安装情况 - 再
try: ver = importlib.metadata.version("click")获取版本 - 用
from packaging import version; version.parse(ver) >= version.parse("8.1.0")做语义化版本比较 - 避免用
sys.version_info类比——那是 Python 解释器版本，不是模块版本
