解决 Homebrew 与系统自带 Python 冲突，优先用 Brew 安装的 Python
一、问题背景
大家在使用 Mac 系统做开发的时候，可能会遇到这么个事儿：系统本身会自带一个 Python 版本，同时呢，咱又用 Homebrew（这是个 Mac 上超好用的包管理工具，就像手机里的应用商店，能轻松下载各种软件）安装了新的 Python 版本。这时候就容易出冲突，比如你在命令行里敲 python 命令，它可能调用的还是系统自带的 Python，而不是你用 Homebrew 装的那个。这可就麻烦了，咱想用新的 Python 版本，却总是用成旧的，咋办呢？下面咱就来一步步解决这个问题。
二、冲突原因分析
系统自带的 Python 是 Mac 系统的一部分，它有自己的安装路径和环境配置。而 Homebrew 安装的 Python 是我们手动安装的，有自己独立的路径。当我们在命令行输入 python 命令时，系统会按照一定的规则去查找 Python 解释器，默认情况下，它可能优先找到系统自带的 Python，这就导致我们想用 Homebrew 安装的 Python 却用不上。
举个例子，系统自带 Python 的路径可能是 /usr/bin/python，而 Homebrew 安装的 Python 路径可能是 /usr/local/bin/python3。当我们输入 python 时，系统先找到了 /usr/bin/python，就用它来执行代码了。
三、解决方法
1. 查看 Python 版本和路径
首先，我们要知道系统里到底有哪些 Python 版本，以及它们都安装在哪里。在终端里输入以下命令：
# 技术栈：Shell
# 查看系统自带 Python 版本
python --version
# 查看系统自带 Python 路径
which python
# 查看 Homebrew 安装的 Python 版本
python3 --version
# 查看 Homebrew 安装的 Python 路径
which python3
运行这些命令后，你就能看到系统自带 Python 和 Homebrew 安装的 Python 的版本和路径了。
2. 修改环境变量
要让系统优先使用 Homebrew 安装的 Python，我们得修改环境变量。环境变量就像是系统的导航地图，告诉系统去哪里找各种程序。我们要把 Homebrew 安装的 Python 路径添加到环境变量里，并且让它排在前面。
打开终端，输入以下命令来编辑环境变量文件：
# 技术栈：Shell
# 打开 .zshrc 文件（如果你用的是 zsh 终端）
open ~/.zshrc
如果你用的是 bash 终端，就打开 .bashrc 文件：
# 技术栈：Shell
# 打开 .bashrc 文件
open ~/.bashrc
在打开的文件里添加以下内容：
# 技术栈：Shell
# 将 Homebrew 安装的 Python 路径添加到环境变量 PATH 中
export PATH="/usr/local/bin:$PATH"
保存文件后，在终端里输入以下命令让修改生效：
# 技术栈：Shell
# 让 .zshrc 文件的修改生效
source ~/.zshrc
# 如果你用的是 bash 终端，就用以下命令
# source ~/.bashrc
现在，再输入 python 命令，系统就会优先使用 Homebrew 安装的 Python 了。
3. 验证修改结果
为了确保修改成功，我们可以再次查看 Python 的版本和路径：
# 技术栈：Shell
# 查看当前使用的 Python 版本
python --version
# 查看当前使用的 Python 路径
which python
如果输出的版本和路径是 Homebrew 安装的 Python 的信息，那就说明修改成功啦。
四、应用场景
1. 开发新项目
当你开始一个新的 Python 项目时，可能需要使用最新版本的 Python 来利用新的特性和功能。通过优先使用 Homebrew 安装的 Python，你可以确保项目在最新的 Python 环境下运行，避免因系统自带 Python 版本过旧而导致的兼容性问题。
比如，你要开发一个使用 Python 3.9 新特性的项目，而系统自带的 Python 版本是 3.7，这时候就需要优先使用 Homebrew 安装的 Python 3.9。
2. 运行特定依赖的脚本
有些 Python 脚本依赖于特定版本的 Python 库，而这些库可能只有在较新的 Python 版本下才能正常工作。通过优先使用 Homebrew 安装的 Python，你可以保证这些脚本能够顺利运行。
例如，某个脚本依赖于 asyncio 库的新特性，而这些特性只有在 Python 3.8 及以上版本才能使用，这时候就需要使用 Homebrew 安装的 Python 3.8 或更高版本。
五、技术优缺点
优点
- 灵活性高：可以自由选择使用 Homebrew 安装的 Python 版本，满足不同项目的需求。
- 更新及时：Homebrew 会及时更新 Python 版本，让你能使用到最新的 Python 特性。
- 易于管理：通过修改环境变量，就能轻松控制使用哪个 Python 版本。
缺点
- 配置复杂：对于初学者来说，修改环境变量可能有一定难度，需要仔细操作，否则可能会导致系统出现问题。
- 可能影响系统稳定性：如果配置不当，可能会影响系统自带 Python 的正常使用，甚至导致系统出现故障。
六、注意事项
1. 备份重要文件
在修改环境变量之前，最好备份 .zshrc 或 .bashrc 文件，以防修改过程中出现错误导致文件损坏。可以使用以下命令备份：
# 技术栈：Shell
# 备份 .zshrc 文件
cp ~/.zshrc ~/.zshrc.backup
# 如果你用的是 bash 终端，备份 .bashrc 文件
# cp ~/.bashrc ~/.bashrc.backup
2. 谨慎修改
在编辑环境变量文件时，要仔细检查输入的内容，确保没有拼写错误或语法错误。如果不确定怎么修改，可以参考相关文档或咨询有经验的开发者。
3. 测试修改结果
修改环境变量后，一定要进行测试，确保系统能够正常使用 Homebrew 安装的 Python。可以编写一个简单的 Python 脚本进行测试：
# 技术栈：Python
# 简单的 Python 脚本，打印当前 Python 版本
import sys
print(sys.version)
保存为 test.py，然后在终端里运行：
# 技术栈：Shell
python test.py
如果输出的是 Homebrew 安装的 Python 版本信息，就说明修改成功了。
七、文章总结
通过以上步骤，我们成功解决了 Homebrew 与系统自带 Python 冲突的问题，实现了优先使用 Homebrew 安装的 Python 版本。首先，我们分析了冲突的原因，了解到系统查找 Python 解释器的规则。然后，通过查看 Python 版本和路径，修改环境变量，让系统优先使用 Homebrew 安装的 Python。最后，我们验证了修改结果，确保一切正常。
在实际应用中，优先使用 Homebrew 安装的 Python 可以满足不同项目的需求，提高开发效率。但同时也要注意修改环境变量的复杂性和可能带来的风险，谨慎操作，确保系统的稳定性。
评论