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

在 macOS 上开始使用 Python 3 有几种方法，但其中一种方法比其他方法更好。

图片来自

Opensource.com

我正在重新开始 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.

所以，我做了我们任何一个人都会做的事情，在谷歌上搜索了一个指南来更新我的开发环境，该环境运行在 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 安装程序我们可以下载并使用。如果我们使用软件包安装，则 **python3** 文件将在 **/usr/local/bin/** 中可用。

别名是必须的，因为存储在 **/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 瓶更新为指向最新版本。由于 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** 命令位于以前的版本上，我们必须单独为我们的 **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，并使用 alias 都可以让你开始编写代码，但从长远来看，这不是一个好的策略。使用 pyenv 作为一个简单的版本管理解决方案，可以让你有一个良好的开端。

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

标签

Python