macOS和Linux下怎么设置Python环境变量

Ryan

发布时间：2026-10-11 | 5人浏览过

原创

在 macOS 和 Linux 终端中，设置 Python 环境变量的核心操作是：找到 Python 可执行程序或模块所在的目录，将该目录导出到 PATH 变量中，并把这条导出命令写入当前用户所用 Shell 的启动配置文件（如 .zshrc 或 .bashrc）。完成配置并重新加载文件后，系统便能在任意终端窗口中正确识别并执行指定的 Python 命令。

一、PATH 环境变量的检索机制

当在终端中输入 python3 并按下回车时，操作系统并不会全盘扫描硬盘查找程序。它会读取一个名为 PATH 的系统变量。PATH 的本质是由半角冒号（:）隔开的一串目录路径清单。

终端会严格按照该清单从左往右的先后顺序依次进入各个目录，查找是否存在名为 python3 的可执行文件。一旦在前面的目录中找到，就会立即启动该程序，并不再继续查找后续目录；如果直到最后一个目录都没找到，系统就会提示 command not found: python3。

macOS和Linux下怎么设置Python环境变量 — 图 1：PATH 环境变量由左至右的命令解析机制

二、配置前的准备：确定当前 Shell 与 Python 路径

设置环境变量前，必须明确两个基础信息：当前终端使用的是哪个 Shell（决定改写哪个配置文件），以及需要配置的 Python 安装在哪个绝对路径。

1. 确认当前终端所用的 Shell

在终端中执行以下命令查看当前交互式 Shell：

echo $SHELL

示例输出与对应规则如下：

若输出 /bin/zsh，配置文件为当前用户家目录下的 ~/.zshrc（macOS Catalina 及以后的系统默认使用 zsh）。
若输出 /bin/bash，配置文件为 ~/.bashrc（多数 Linux 发行版，如 Ubuntu、Debian 默认使用 bash；macOS 下也可使用 ~/.bash_profile）。

2. 查找目标 Python 的具体路径

如果已经通过系统包管理器（如 Homebrew、apt）或官方安装包安装了 Python，可以使用 which 查询现有路径：

which python3

终端会输出类似 /usr/local/bin/python3、/opt/homebrew/bin/python3 或 /usr/bin/python3 的实际路径。若是自定义编译安装或放置在独立文件夹（如 /opt/python311/bin），请记录该可执行程序所在的 bin 目录，后文将以该目录作为目标路径展开。

三、核心操作步骤：修改并加载配置文件

将路径写入配置文件，可以让环境变量在终端关闭重启后持续生效。完整操作可划分为“确认路径、编辑写入、重新载入、校验结果”四步。

步骤 1：打开配置文件

使用命令行文本编辑器打开配置文件。如果使用的是 zsh（macOS 默认），执行：

nano ~/.zshrc

如果使用的是 bash（Linux 常见默认），执行：

nano ~/.bashrc

步骤 2：添加 PATH 导出语句

移动到文件最底部，另起一行，添加导出语句。语法格式如下：

export PATH="/目标路径/bin:$PATH"

示例场景：假设在 Linux 服务器上通过源代码将 Python 3.11 编译安装到了 /usr/local/python311 目录下，或者希望把本地用户安装的 ~/.local/bin（pip 安装 CLI 工具的默认路径）加入环境，配置语句应写为：

# 添加自定义安装的 Python 目录
export PATH="/usr/local/python311/bin:$PATH"

# 或者添加 pip 用户级工具目录
export PATH="$HOME/.local/bin:$PATH"

重要注意事项：必须保留末尾的 :$PATH。如果在赋值时漏写了 :$PATH，会导致原有的系统路径（如 /bin、/usr/bin）被全部冲掉，造成 ls、cat 等基础系统命令失效。如果不慎清空，直接退出当前终端重开即可恢复默认值。

在 nano 编辑器中，按 Ctrl + O 接着按回车保存文件，然后按 Ctrl + X 退出。

步骤 3：让修改立即生效

编辑保存后，当前打开的终端并不会自动加载新内容。可以通过 source 命令在当前会话中快速激活：

针对 zsh：

source ~/.zshrc

针对 bash：

source ~/.bashrc

执行该命令没有任何输出即代表加载成功。随后新建的任何终端标签页都会默认应用该配置。

步骤 4：验证配置结果

在终端中检查实际调用的 Python 是否已经变更为预期的路径与版本：

which python3
python3 --version

示例输出：

/usr/local/python311/bin/python3
Python 3.11.8

输出路径若与刚配置的目录完全一致，则说明全局环境变量已经顺利绑定。

四、两类主要环境的典型配置场景

macOS 与 Linux 虽然同属 Unix 系列系统，但在默认包管理工具和路径规范上存在差异，具体场景中的配置路径各有侧重。

1. macOS 下的 Homebrew 与多架构路径

macOS 用户普遍使用 Homebrew 安装环境。搭载 Apple Silicon 芯片（M1/M2/M3/M4 系列）的 Mac，Homebrew 默认安装在 /opt/homebrew；而早期 Intel 芯片的 Mac 则位于 /usr/local。

如果发现 brew install python 后系统仍旧调用旧版本，只需将 Homebrew 的路径放在最前面：

# Apple Silicon Mac 配置：
export PATH="/opt/homebrew/bin:$PATH"

# Intel Mac 配置：
export PATH="/usr/local/bin:$PATH"

2. Linux 下将 `python` 映射为 `python3`

在现代 Linux 发行版（如 Ubuntu 20.04+、Debian 12、CentOS 9）中，系统仅默认提供 python3 命令，直接敲 python 常提示找不到命令。此时不需要在根目录乱建软链接，可以在 ~/.bashrc 中添加别名：

alias python=python3

这样既保证了键入 python 时自动重定向到 python3，又不会破坏底层依赖系统原生 Python 的自动化维护脚本。

五、进阶补充：PYTHONPATH 模块检索变量

除了执行程序的 PATH 外，另一个常用的环境变量是 PYTHONPATH。

当项目包含多个自定义模块，或者在跨目录执行脚本时，Python 会根据其内部的 sys.path 清单去寻找 import 的包。如果自定义代码不在当前脚本目录，Python 会报错 ModuleNotFoundError。

此时可以通过配置 PYTHONPATH 将自定义项目的根目录加入进去：

export PYTHONPATH="/Users/username/my_project:$PYTHONPATH"

这样无论在系统的哪个路径下运行 Python 脚本，都可以自由 import 该项目内的各种公共包与工具类。

六、核心总结与避坑要点

合理设置环境变量是搭建顺畅开发环境的第一步，掌握清晰的配置原则能够避免绝大部分版本混淆与环境冲突。

最后，总结配置中的三项关键原则：

不要直接覆盖系统原生默认 Python：在 Linux 系统中，许多系统级管理模块（如 apt、firewalld）都紧密绑定特定版本的 Python，不要强行删除或替换 /usr/bin/python3 软链接。若要使用较新版本，应该通过优先拼接 PATH 前缀或创建专用虚拟环境（venv）来实现安全隔离。
改动后及时重载确认：每次保存文件后，牢记运行 source <配置文件>，或完全关闭终端重新打开，随后用 which python3 确认命令解析生效。
保持配置干净有序：避免在 ~/.profile、~/.bash_profile 和 ~/.zshrc 中来回重复添加相同内容，认准当前终端正在使用的单一配置文件进行维护即可。