OSX 10.11.6 El Capitan下sphinxcontrib-bibtex编译错误求助

你的问题很明确——sphinxcontrib.bibtex扩展找不到oset模块，这是因为你用的0.4.0版本的sphinxcontrib-bibtex依赖这个第三方模块，而你的环境里没安装它。下面是一步步的解决办法：

1. 安装缺失的oset模块 #

打开终端，直接通过pip安装oset：

pip install oset

如果碰到系统Python权限报错（比如无法写入全局目录），可以添加--user参数安装到用户专属目录：

pip install --user oset

2. 验证安装是否成功 #

安装完成后，在终端输入python进入交互模式，执行import oset，如果没有报错，说明模块安装成功。此时再运行make html应该就能正常编译了。

备选方案：调整版本兼容性 #

如果上述方法无效，可能是Sphinx 1.7.4和sphinxcontrib-bibtex 0.4.0存在版本适配冲突，可以尝试以下两种调整方向：

• 降级Sphinx到编译日志显示的1.6.3版本：

pip install sphinx==1.6.3

• 升级sphinxcontrib-bibtex到0.6.x版本（该版本后不再依赖oset）：

pip install --upgrade sphinxcontrib-bibtex==0.6.2

注意：升级bibtex版本后，建议检查项目的conf.py配置文件，新版本的部分API用法可能有变化。

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