在 Mac 上将 Python 3 设置为默认值的正确和错误方法

我一直在重新涉足 Python 开发，因为我准备前往 PyCon US。（如果您也要去那里并想分享您的 Python 故事，请告诉我！）当我安装一个模块进行修补时，我得到一个提醒，我需要尽快安装 Python 3。

$ pip install todoist-python 
DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7.

因此，我做了我们任何人都会做的事情，并在 Google 上搜索指南来更新我的开发环境，该环境在 Mac（macOS 操作系统，以前称为 OS X）上运行。令我惊讶的是，我只找到了一些 StackOverflow 帖子，它们指向了部分解决方案。这是关于如何设置您的环境而不破坏 macOS 操作系统中内置的任何内容的完整故事。

 1. 安装 pyenv

Moshe Zadka 警告说，这样做如果出错，可能会导致对正在运行的 Python 的不可靠的想法，这过于依赖于加载别名的 shell。我知道 Moshe 熟悉 Python，但我不知道的是，他也是许多 Python 教程的作者，以及一本即将出版的关于 macOS 上 Python 开发的书籍。他帮助 40 位同事在 macOS 系统上安全且一致地开发 Python，遵循一个核心原则

“所有 Python 开发的基本前提是永远不要使用系统 Python。您不希望 Mac OS X 的‘默认 Python’是‘python3’。您希望永远不要关心默认 Python。”

我们如何停止关心默认值？Moshe 建议使用 pyenv 来管理 Python 环境（有关配置 pyenv 的深入探讨，请参阅本文）。此工具管理多个版本的 Python，并被描述为“简单、不突兀，并遵循 Unix 的单一用途工具的传统，这些工具可以很好地完成一件事。”

虽然还有其他 安装选项 可用，但最简单的入门方法是使用 Homebrew

$ brew install pyenv 
?  /usr/local/Cellar/pyenv/1.2.10: 634 files, 2.4MB

2. 安装 Python

现在让我们安装最新的 Python 版本（截至撰写本文时为 3.7.3）

$ pyenv install 3.7.3
python-build: use openssl 1.0 from homebrew
python-build: use readline from homebrew
Downloading Python-3.7.3.tar.xz...
-> https://pythonlang.cn/ftp/python/3.7.3/Python-3.7.3.tar.xz
Installing Python-3.7.3...
## further output not included ##

3. 设置您的全局默认值

现在 Python 3 已通过 pyenv 安装，我们希望将其设置为 pyenv 环境的全局默认版本

$ pyenv global 3.7.3
# and verify it worked 
$ pyenv version
3.7.3 (set by /Users/mbbroberg/.pyenv/version)

pyenv 的强大功能来自其对我们 shell 路径的控制。为了使其正常工作，我们需要将以下内容添加到我们的配置文件中（我的 .zshrc，可能是您的 .bash_profile）

$ echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.zshrc

在执行该命令后，我们的点文件（zsh 的 .zshrc 或 Bash 的 .bash_profile）应包含以下行

if command -v pyenv 1>/dev/null 2>&1; then
  eval "$(pyenv init -)"
fi

现在我们确信我们正在使用 Python 3.7.3，并且 pip 将随之更新，而无需在版本之间进行任何手动别名。使用 Moshe 推荐的版本管理器 (pyenv) 使我们能够轻松接受未来的升级，而不会对我们在给定时间运行的 Python 版本感到困惑。

成功

当您熟悉此工作流程后，您可以使用 pyenv 来管理多个版本的 Python。对于依赖项管理，使用虚拟环境也是必不可少的。我在文章中提到了如何使用内置的 venv 库，Moshe 建议使用 virtualenvwrapper 来管理虚拟环境。

了解 Python 运行时

现在您已经修复了 Python 版本，可以安全地探索为什么这个问题困扰着这么多人。

macOS 附带的 Python 版本与 Python 推荐用于开发的版本相差甚远。正如 XKCD 指出的那样，思考 Python 运行时有时会非常可笑。

许多用户已经在他们的计算机上安装了数十个 Python 解释器，但不知道如何有效地管理它们。通常，人们只是下载最新的 Python 版本，将其移动到他们的 路径，然后就此罢休（或使用 brew install python3，这将做类似的事情）。这可能会在将来以令人沮丧的方式导致崩溃，这些崩溃可能难以排除故障。

不要做什么

关于如何使 Python 3 成为系统上的默认 Python 的我的第一个想法是移动旧版本并添加新版本

# what I thought would work 
# first, I'll find my python binary 
$ which python 
/usr/bin/python 
# next, I'll move it to an unused name 
$ sudo mv /usr/bin/python /usr/bin/python2 
# lastly, I'll move the new binary to the previous path 
$ sudo mv $PATHTOBINARY/python3 /usr/bin/python 

该模式遵循 /usr/bin/ 在 Python 的主要版本之间通常所做的操作，但我很快就了解到这是错误的举动

$ sudo mv /usr/bin/python /usr/bin/python2 
mv: rename /usr/bin/python to /usr/bin/python2: Operation not permitted 

值得庆幸的是，macOS 保护了我，免于破坏我不完全理解的东西。进一步的研究证明，这正是我们不应该做的。

另一件不要尝试的事情

现在我们知道不该做什么，让我们看看我们可以做什么。当我们考虑 macOS 上应用程序的常见安装模式时，有几个选项。

将 Python 3 用作 macOS 默认值

Python 的网站有一个 macOS Python 3 安装程序，我们可以下载并使用。如果我们使用软件包安装，则 /usr/local/bin/ 中将提供 python3 填充。

别名是必须的，因为存储在 /usr/bin/ 中的 Python 二进制文件无法更改。别名的好处是它特定于我们的命令行 shell。由于我默认使用 zsh，因此我将以下内容放入 .zshrc 文件中

$ echo "alias python=/usr/local/bin/python3.7" >> ~/.zshrc 

如果您使用的是默认的 Bash shell，则可以将相同的文本附加到您的 .bashrc

$ echo "alias python=/usr/local/bin/python3.7" >> ~/.bashrc 

此策略有效，但对于将来更新 Python 来说并不理想。这意味着我们必须记住检查网站并下载新文件，因为 Python 不包含命令行更新方式。

让 Homebrew 管理 Python 3

Homebrew 项目为 macOS 提供了一个免费和开源的软件包管理器，许多人依赖它。它为 Apple 用户提供了类似于 apt-get 或 yum 的功能。如果您是 Homebrew 用户，您可能已经安装了 Python。要快速检查，请运行

$ brew list | grep python 
python 

如果 Python 出现在命令下，则表示已安装。它是什么版本？让我们检查一下

$ brew info python 
python: stable 3.7.3 (bottled), HEAD 
Interpreted, interactive, object-oriented programming language 
https://pythonlang.cn/ 
/usr/local/Cellar/python/3.7.2_1 (8,437 files, 118MB) * 
## further output not included ##

好的，太棒了！Homebrew 维护人员已更新默认 Python bottle 以指向最新版本。由于 Homebrew 维护人员在更新版本方面比我们大多数人更可靠，因此我们可以使用 Homebrew 版本的 Python 3，命令如下

$ brew update && brew upgrade python 

现在我们要将我们的别名（来自上面）指向 Homebrew 管理的 Python 副本

# If you added the previous alias, use a text editor to update the line to the following 
alias python=/usr/local/bin/python3 

为了确保上面的路径指向 Homebrew 在我们的环境中安装 Python 的位置，我们可以运行 brew info python 并查找路径信息。

这种使用 Homebrew 管理我们的 Python 环境的方法是一个很好的起点，并且在当时对我来说很有意义。

如果我们仍然需要 Python 2 怎么办？

对于任何 Python 新手来说，从 Python 3 开始是有道理的。但是，对于那些仍然需要 Python 2 的人（例如，为了贡献一个仅在 Python 2 中可用的 Python 项目），可以继续使用 /usr/bin/python 中提供的默认 macOS Python 二进制文件

$ /usr/bin/python 
>>> print("This runtime still works!") 
This runtime still works! 

Homebrew 非常出色，它甚至为 Python 2 提供了不同的公式

# If you need Homebrew's Python 2.7 run 
$ brew install python@2 

在任何时候，我们都可以从 shell 的配置文件中删除别名，以返回使用系统上的默认 Python 副本。

不要忘记将 pip 更新为 pip3！

pip 命令是专门用于 Python 包的默认包管理器。尽管我们将默认 Python 命令更改为版本 3，但如果我们的 pip 命令是以前的版本，我们必须单独别名它。首先，我们需要检查我们所处的版本

# Note that this is a capital V (not lowercase) 
$ pip -V 
pip 19.0.3 from /Library/Python/2.7/site-packages/pip-19.0.3-py2.7.egg/pip (python 2.7)

为了确保我们安装的软件包与我们的新 Python 版本兼容，我们将使用另一个别名来指向兼容版本的 pip。由于在这种情况下我们使用 Homebrew 作为我们的软件包管理器，我们知道它在安装 Python 3 时安装了 pip3。默认路径应该与 Python 3 相同，但我们可以通过要求 shell 查找它来确认这一点

$ which pip3 
/usr/local/bin/pip3 

现在我们知道了位置，我们将像之前一样将其添加到我们的 shell 配置文件中

$ echo "alias pip=/usr/local/bin/pip3" >> ~/.zshrc  
# or for Bash 
$ echo "alias pip=/usr/local/bin/pip3" >> ~/.bashrc

最后，我们可以通过打开一个新的 shell 或重置我们当前的 shell 并查看我们指向的内容来确认运行 pip 指向 pip3

# This command reloads the current shell without exiting the session 
# Alternatively, exit the shell and start a new one
$ exec $0
# Now we can look to see where pip points us 
$ which pip 
pip: aliased to /usr/local/bin/pip3

我们可以避免使用 Homebrew 更新 pip，但这需要 Python 文档中更长的 教程。

从一开始就做对

如果您刚开始在 macOS 上进行 Python 开发，请进行必要的配置，以确保从一开始就使用正确版本的 Python。安装 Python 3，无论是否使用 Homebrew，并使用别名都可以让您开始编码，但这从长远来看并不是一个好策略。使用 pyenv 作为简单的版本管理解决方案，让您有一个良好的开端。

---

本文最初于 2019 年 5 月发布，并已由编辑更新。