Python：没有名为sphinx错误的模块

Question

我跟随了guide。

$ pip install sphinx sphinx-autobuild
$ pip freeze | grep "sphinx"
sphinx-autobuild==0.6.0
sphinxcontrib-websupport==1.0.0

$ cd docs
$ sphinx-quickstart
$ make html

make html给出以下错误：

/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python: No module named sphinx
make: *** [help] Error 1

[问]我怎样才能防止这种错误发生？

感谢您宝贵的时间和帮助。

Answer 1

首先，不要在系统的Python中安装任何东西。使用虚拟环境或系统的用户安装来隔离系统Python中的软件包。 Python Packaging Authority提供了why virtual environments are a good idea™的解释。

我更喜欢首先在我的系统上安装另一个版本的Python，使用official installers for macOS（初学者）或pyenv（不是初学者）。除非绝对必须使用Python 2，否则请安装Python 3.x.

下一个install or upgrade your Python's packaging tools。这是我在Pythons中安装或升级软件包的极少数情况之一，尽管您可能希望为您的用户这样做。

下一个create and use a virtual environment。

最后，按照correct guide to install Sphinx进入您的虚拟环境，开始使用Sphinx。

Answer 2

我有同样的问题，我认为分享我找到的解决方案可能会有所帮助。

打开Makefile文件，然后更改以下行：

SPHINXBUILD = python -msphinx

对于这个：

SPHINXBUILD = python3 -msphinx