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 包装管理局提供了 why virtual environments are a good idea™ 的解释。

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

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

下一个create and use a virtual environment.

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

Answer 2

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

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

SPHINXBUILD = python -msphinx

给这个：

SPHINXBUILD = python3 -msphinx

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

Python: No module named sphinx error

python

pip

python-sphinx