多版本Python共存时怎么通过环境变量管理默认版本

当一台电脑上同时安装了多个版本的 Python 时，系统终端直接输入 python 该启动哪一个，本质上完全由环境变量中的 PATH 检索顺序决定。要切换默认版本，核心做法并不是反复卸载重装，而是调整 PATH 列表中对应 Python 主程序所在目录的先后位次，让目标版本的路径排在其他版本之前。

1. 环境变量决定默认版本的运行机制

操作系统在运行用户输入的命令时，并不会全局深度搜索硬盘，而是依照环境变量 PATH 中定义的一组文件路径，从前往后逐个检查。一旦在排在前面的某一个目录中找到了名为 python.exe（Windows）或 python（macOS/Linux）的可执行文件，系统就会立即将其启动并终止搜索。

这意味着，后出现的同名程序即使版本更新，也会被彻底忽略。因此，环境变量管理默认版本的本质，就是利用 PATH 的“从左往右（或从上到下）的首次命中截断”特性，把想要作为默认版本的安装目录与配套的 Scripts（或 bin）目录，置顶到其他同名路径的前面。

图 1：PATH 路径查找的首次命中与截断机制

2. Windows 系统下的具体配置步骤

在 Windows 操作系统中，配置环境变量需要通过系统高级设置界面进行。每个 Python 版本通常包含两个关键目录：一个是存放 python.exe 的安装根目录，另一个是存放 pip.exe 及各种第三方工具的 Scripts 目录。两者必须保持同版本且成对管理。

2.1 打开并编辑环境变量

1. 按下快捷键 Win + R，在运行对话框中输入 sysdm.cpl 并回车，打开“系统属性”窗口。
2. 切换至“高级”选项卡，点击底部的“环境变量”按钮。
3. 在下方的“系统变量”或上方的“用户变量”中找到名为 Path 的变量，选中后点击“编辑”。

2.2 调整条目顺序

假设电脑上同时装有 Python 3.12 和 Python 3.9，当前希望将默认版本设定为 Python 3.12。在“编辑环境变量”界面中，通过右侧的“上移”按钮，把 Python 3.12 对应的两条路径移动到 Python 3.9 之上：

• C:\Users\Admin\AppData\Local\Programs\Python\Python312\
• C:\Users\Admin\AppData\Local\Programs\Python\Python312\Scripts\

图 2：Windows 下通过 GUI 界面调整环境变量的标准流程

3. Linux 与 macOS 系统下的具体配置步骤

类 Unix 系统没有可视化的变量编辑列表，而是通过 Shell 启动脚本（如 ~/.bashrc 或 ~/.zshrc）来导出 PATH 字符串。在这些系统中，多个目录通过半角冒号（:）相连。

3.1 修改配置文件

查看当前正在使用的终端类型，输入 echo $SHELL。如果是 Zsh（macOS 默认），编辑 ~/.zshrc；如果是 Bash（常见于 Ubuntu 等 Linux），编辑 ~/.bashrc。

# 打开当前用户的配置文件（以 zsh 为例）
nano ~/.zshrc

在文件最底部添加导出语句，将目标 Python 版本的 bin 路径拼接到原始 $PATH 的最前端：

# 将 Python 3.12 设定为优先检索
export PATH="/usr/local/opt/python@3.12/bin:$PATH"

这里的语法要点在于 $PATH 必须写在冒号后面。这样拼接出来的最终字符串中，/usr/local/opt/python@3.12/bin 就会排在最左侧，拥有最高命中优先级。

3.2 立即应用变更

保存文件后，在当前终端执行加载命令使其立即生效，无需注销电脑：

source ~/.zshrc

4. 变更后的验证与排错

配置完成后，必须实际验证默认版本是否已被接管，同时检查可执行文件的具体指向。

4.1 确认版本号与物理路径

打开全新的终端窗口，分别执行以下命令进行核验：

# 示例命令：查看当前默认 Python 版本
python --version

# 示例命令：查看当前默认 Pip 版本及其归属路径
pip --version

# 示例命令：查看系统找到该命令的具体路径
# Windows 命令提示符 (CMD):
where python

# macOS / Linux:
which python

执行 where python 后的示例输出如下：

C:\Users\Admin\AppData\Local\Programs\Python\Python312\python.exe
C:\Users\Admin\AppData\Local\Programs\Python\Python39\python.exe

在输出列表中排在第一行的路径，就是当前系统实际使用的默认程序。只要第一行显示的是目标版本，说明配置成功。

图 3：默认版本不生效时的常见排查分支

4.2 Windows 特殊排错：应用执行别名

在 Windows 10 与 11 中，如果使用 where python 发现排在最前面的路径是 C:\Users\用户名\AppData\Local\Microsoft\WindowsApps\python.exe，而且终端提示跳转到应用商店，这是微软内置的应用别名拦截了命令。

解决方式：打开 Windows“设置” -> “应用” -> “高级应用设置” -> “应用执行别名”，在列表中将“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”两个开关全部关闭即可。

5. 核心逻辑总结与操作对照

管理默认 Python 版本并不需要改动软件本身的内部配置。只要抓住操作系统的执行原理，通过对 PATH 环境变量施加控制，就能在多个版本之间自由切换。

图 4：跨平台环境变量管理 Python 默认版本要素一览

只要保持路径完整（解释器目录与 Scripts/bin 目录同步调整），并在修改后重新启动终端，你就可以在不破坏旧项目依赖的前提下，随时按需指派任意版本成为全局默认的 Python。