安装主题后运行mkdocs报错：主题名称冲突问题求助

这个错误的核心原因很明确：你安装的某个第三方包提供了一个和MkDocs内置readthedocs主题同名的主题，导致MkDocs在加载主题列表时出现冲突，无法确定优先使用哪一个。结合你的Mac + Python 2.7.15 + PIP 20.0.2环境，可按以下步骤解决：

步骤1：定位冲突的第三方包 #

先找出是哪个包在和内置主题抢名字，在终端运行：

pip list | grep -i readthedocs

这个命令会列出所有名称包含readthedocs的已安装包，你要找的就是类似mkdocs-readthedocs这类提供同名主题的第三方包。

步骤2：卸载冲突的包 #

找到目标包后，用pip卸载它。比如如果查到的是mkdocs-readthedocs，就运行：

pip uninstall mkdocs-readthedocs

卸载时会提示确认，输入y回车即可完成操作。

步骤3：验证问题是否解决 #

卸载完成后，运行任意MkDocs命令测试，比如：

mkdocs --version

或者直接启动本地预览服务：

mkdocs serve

如果没有再弹出主题重名的错误，就说明问题已经解决了。

额外建议 #

注意到你使用的是Python 2.7，而MkDocs从1.0版本开始就停止了对Python 2.7的支持。Python 2.7早已停止官方维护，后续可能会遇到更多依赖兼容性问题，建议尽量升级到Python 3.x版本，能避免很多类似的奇怪问题。

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