Google Colab导入gensim 3.8时遇collections.Mapping导入错误求助

问题背景 #

在Google Colab运行LDA项目时，安装Gensim 3.8后导入模块触发ImportError，提示无法从collections导入Mapping，当前环境为Python 3.10.11。

执行代码：

#Upgrade Gensim + Dependecies
!pip install --upgrade gensim==3.8
from collections.abc import Mapping
import gensim
import gensim.corpora as corpora
from gensim.utils import simple_preprocess
from gensim.models.wrappers import LdaMallet
from gensim.models.coherencemodel import CoherenceModel
from gensim import similarities
import pandas as pd
import os.path
import re
import glob

错误核心信息：

ImportError: cannot import name 'Mapping' from 'collections' (/usr/lib/python3.10/collections/__init__.py)

原因分析 #

Python 3.10将抽象基类（如Mapping）从collections模块迁移到了collections.abc模块，而Gensim 3.8是2019年发布的版本，未适配该变更，内部代码仍使用from collections import Mapping，导致导入失败。手动导入collections.abc.Mapping无法解决Gensim内部代码的问题。

解决方案 #

方案1：升级Gensim到兼容Python 3.10的版本 #

Gensim 4.1.0及以上版本已适配Python 3.10，同时注意模块路径变化（如LdaMallet从models.wrappers移到models）：

# 安装兼容版本的Gensim
!pip install --upgrade gensim>=4.1.0

# 导入适配后的模块
import gensim
import gensim.corpora as corpora
from gensim.utils import simple_preprocess
# Gensim4.x中LdaMallet的导入路径变更
from gensim.models import LdaMallet
from gensim.models.coherencemodel import CoherenceModel
from gensim import similarities
import pandas as pd
import os.path
import re
import glob

方案2：降级Python版本到3.9及以下（保留Gensim 3.8） #

若必须使用Gensim 3.8，需在Colab中切换到Python 3.9环境：

# 更新软件源并安装Python3.9
!apt-get update -y
!apt-get install python3.9 python3.9-dev python3.9-distutils -y

# 设置Python3.9为默认版本
!update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 1
!update-alternatives --install /usr/bin/python python /usr/bin/python3.9 1

# 安装适配Python3.9的pip
!curl https://bootstrap.pypa.io/get-pip.py | python3.9

# 安装Gensim3.8
!pip install gensim==3.8

# 导入模块（原代码路径不变）
import gensim
import gensim.corpora as corpora
from gensim.utils import simple_preprocess
from gensim.models.wrappers import LdaMallet
from gensim.models.coherencemodel import CoherenceModel
from gensim import similarities
import pandas as pd
import os.path
import re
import glob

注意：切换Python版本后，可能需要重新安装项目依赖（如pandas、numpy等），确保环境一致性。

内容的提问来源于stack exchange，提问作者Александр Е.