spaCy导入SpanGroup报ModuleNotFoundError，求正确导入方法

核心原因 #

SpanGroup是spaCy v3.0及以上版本才新增的类，v2.x版本的spaCy不包含该API，这是导入失败最常见的诱因。

操作步骤 #

• 首先确认当前环境的spaCy版本，运行命令：
  pip show spacy
  若返回的Version字段低于3.0.0，先执行升级操作：
  pip install --upgrade spacy
• 升级到适配版本后，使用官方推荐的导入语句即可：
  from spacy.tokens import SpanGroup
• 若上述导入仍报错，可尝试备用的子模块导入方式：
  from spacy.tokens.span_group import SpanGroup

异常排查 #

如果版本确认无误仍触发ModuleNotFoundError，优先排查环境一致性问题：确认当前运行代码的Python解释器，和执行pip命令安装/升级spaCy的解释器为同一个，避免多Python环境导致的安装错位。

内容的提问来源于stack exchange，提问作者carrot_142