Jenkins构建站点阶段ImportError求助：无法导入collections的Sequence

错误原因 #

Python 3.10对标准库结构做了调整，Sequence 类不再直接从collections模块导出，而是迁移到了collections.abc模块中。你当前使用的mkdocs版本未适配这个变化，导致导入失败。

解决方案 #

• 升级mkdocs到兼容版本：在Jenkins构建的Shell脚本中，先执行升级命令再构建：

  pip install --upgrade mkdocs
  mkdocs build
  

• 降级Python版本：将Jenkins构建环境的Python版本切换到3.9或更低版本，确保与现有mkdocs版本兼容。
• 临时修改依赖文件（不推荐）：找到mkdocs安装目录下的config_options.py文件，将开头的导入语句修改为：

  from collections.abc import Sequence
  from collections import namedtuple
  

  注意：这种方法需要修改第三方依赖文件，后续升级mkdocs时会被覆盖，仅作为临时应急方案。

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