Python 环境变量的配置核心目的，是让操作系统在任意命令行窗口都可以识别 python 和 pip 命令，不用每次都输入完整安装路径，安装 Python 之后如果没有正确配置环境变量，在 cmd 或者终端输入 python 就会提示不是内部或外部命令。操作系统运行命令的时候，会按照环境变量里面的路径列表依次查找对应的可执行程序，Python 主程序 python.exe 和 pip.exe 存放在安装目录以及 Scripts 子目录，这两个路径都需要加入系统 PATH 变量，配置完成之后重启终端才能生效，很多人配置失败都是因为忘记重启终端，或者只添加了主目录漏掉 Scripts 文件夹，导致 pip 命令无法正常调用。

一 环境变量基础认知

PATH 属于系统环境变量，本质是一组文件夹路径集合，系统执行外部命令时，会遍历 PATH 内所有目录，查找同名可执行文件。

Python 需要添加的两个核心目录

补充区分 用户环境变量 和 系统环境变量

用户环境变量 只对当前登录用户生效

系统环境变量 对电脑全部用户生效，修改需要管理员权限

二 Windows 系统配置步骤

1 打开此电脑，右键选择属性，找到高级系统设置，点击环境变量按钮

2 在变量列表找到 Path，选中之后点击编辑

3 点击新建，依次添加 Python 主安装路径，还有 Scripts 子目录路径

4 添加完成之后全部点击确定保存所有窗口

5 关闭已经打开的 cmd 窗口，重新打开新的命令提示符

6 校验命令 输入 python --version 输入 pip --version，可以正常输出版本号代表配置成功

安装包自带选项说明，安装 Python 的时候，界面底部有 Add Python to PATH 勾选框，勾选之后安装程序会自动完成环境变量配置，这是最简单的方式，新手优先勾选，不需要手动修改。

三 Mac 和 Linux 系统配置步骤

Mac 与 Linux 是通过 shell 配置文件来修改 PATH，不同终端对应的配置文件不一样

操作流程

1 打开终端，确认 python 安装路径，使用 which python3 查询路径

2 打开对应配置文件，写入 export PATH 加上 python 目录以及 Scripts 目录，放到原有路径前面

3 保存文件之后，执行 source 命令让配置立即生效

4 终端输入 python3 --version 校验是否成功

注意 Linux 系统很多自带 python2，所以一般使用 python3 区分，不要混淆 python 和 python3 命令。

四 常见报错与踩坑排查

五 进阶补充说明

多版本 Python 共存场景，不建议依靠修改 PATH 切换版本，可以使用虚拟环境 pyenv 这类版本管理工具，避免手动修改环境变量造成版本混乱。

环境变量配置属于一次性基础设置，只要不删除 Python 安装目录，一般不需要重复修改，如果之后移动 Python 安装文件夹，原环境变量路径就会失效，需要重新更新 PATH。

整体总结，Python 环境变量配置本质就是把 python.exe 和 pip.exe 所在目录加入系统 PATH，Windows 可以安装时自动勾选或者手动编辑 Path，Mac Linux 修改 shell 配置文件，配置完成重启终端校验版本号，重点留意 Scripts 目录和终端重启这两个容易出错的细节。

【常见问题】

问题 1 Python 环境变量的配置为什么需要添加 Scripts 目录

回答 1 Python 环境变量的配置添加 Scripts 目录，是因为 pip 命令存放在这个目录，缺少该路径就会出现 pip 命令无法识别的问题。

问题 2 Python 环境变量的配置修改之后为什么不生效

回答 2 Python 环境变量的配置修改之后不生效，大多是因为原有终端窗口没有重启，系统仍然读取旧的环境变量，重新打开终端即可加载新配置。

问题 3 Python 环境变量的配置 Windows 安装时可以自动完成吗

回答 3 Python 环境变量的配置 Windows 安装界面勾选 Add Python to PATH，安装程序就会自动完成环境变量配置，适合新手快速完成设置。

问题 4 Python 环境变量的配置多版本共存会有冲突吗

回答 4 Python 环境变量的配置多版本共存的时候，如果 PATH 里面多个版本路径排序不当会出现版本冲突，推荐使用版本管理工具替代手动修改环境变量。

【免责申明】

本文内容基于主流操作系统 Python 环境变量配置方法整理，仅用于学习参考，不同系统版本界面和文件名称可能存在差异，实际操作请结合本机系统情况执行。