Sphinx扩展下载方法及make html报错求助

这问题我之前折腾过好一会儿！核心原因大概率是docutils版本不兼容或者安装不完整，虽然你Sphinx是最新版，但依赖的docutils可能出问题了，试试下面这些步骤：

• 强制重装/更新docutils
  错误直接提示找不到docutils的子模块，先把docutils彻底重装一遍，清除可能的缓存或损坏的安装文件：

  pip install --upgrade --force-reinstall docutils
  

  执行完之后再跑make html试试，很多时候这一步就能解决。

• 确认Python环境一致性
  很多Linux用户会碰到系统Python和虚拟环境混淆的问题，先检查当前终端用的Python和pip是不是同一个环境：

  which python
  which pip
  

  如果路径不一致，说明你可能用了虚拟环境但没激活，或者用了系统pip安装到用户目录但Python用的是系统的。激活你的虚拟环境（比如source your_venv/bin/activate），然后重新安装Sphinx和docutils：

  pip install --upgrade sphinx docutils
  

• 降级docutils到兼容版本
  有时候最新版的docutils和Sphinx存在兼容性bug，试试降级到经过验证的稳定版本，比如0.17.1（这个版本和绝大多数Sphinx版本都能配合）：

  pip install docutils==0.17.1
  

  安装完成后再执行make html，应该能解决模块找不到的问题。

• 检查conf.py的扩展配置
  最后可以看看你的conf.py里的extensions列表，有没有误添加sphinx.builders.latex？不过这个模块是Sphinx自带的，只要依赖没问题应该能导入，所以这一步是兜底检查。

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