python 环境变量设置本质就是把 python 解释器和 pip 工具所在的文件夹路径添加到系统 PATH 变量当中，设置完成之后，不管当前命令行处于哪个目录，都可以直接调用 python 和 pip 命令，不需要每次都输入完整的安装路径。很多新手安装完 python 之后打开 cmd 输入 python 提示不是内部或外部命令，核心原因就是安装阶段没有勾选自动添加环境变量，或者手动添加路径出错，导致系统找不到 python.exe 程序。PATH 变量属于系统级的检索清单，当你在终端输入命令时，系统会依次遍历 PATH 里面所有文件夹，查找同名可执行程序，只要 python.exe 所在目录在 PATH 列表内，终端就可以识别 python 命令，同时 pip 对应的脚本目录也要一并添加，否则会出现 python 可以调用但是 pip 命令无法识别的情况。环境变量分为用户变量和系统变量两种，用户变量只对当前登录账号生效，系统变量对电脑全部用户生效，个人电脑推荐优先配置系统变量，多用户共用电脑则可以按需选择用户变量。
Windows 系统设置步骤
第一种方式是安装 python 时自动配置，运行 python 官方安装包，在安装首页勾选 Add Python to PATH，再点击 Install Now，安装结束就自动完成环境变量，这是最简单的方案，适合还没有安装 python 的用户。
第二种是已经安装 python 之后手动配置，第一步找到 python 安装目录，默认路径一般是 C 盘 Users 用户名 AppDataLocalProgramsPythonPython 版本号，目录里面存在 python.exe，同时同级还有 Scripts 文件夹，这个文件夹存放 pip.exe 等工具。第二步打开系统属性，此电脑右键选择属性，找到高级系统设置，点击环境变量按钮。第三步在系统变量列表找到 Path，双击打开编辑窗口，点击新建，依次填入 python 主目录路径和 Scripts 文件夹路径，确认保存所有窗口。第四步验证，按下 win 加 R 输入 cmd 打开命令提示符，输入 python --version 和 pip --version，如果可以正常输出版本号就代表设置成功。
Mac 与 Linux 系统设置步骤
Mac 和 Linux 一般使用 bash 或者 zsh 终端，环境变量写入 shell 配置文件，常见文件是 bashrc profile zshrc。首先执行 which python3 查询 python3 实际安装路径，复制完整路径。然后打开终端编辑配置文件，使用 vim 或者 nano 编辑器，在文件末尾添加 export PATH=python 路径：PATH，保存退出之后执行 source 对应配置文件让配置立刻生效，不需要重启电脑。之后新开终端输入 python3 --version 验证。注意 mac 系统自带 python 版本和自行安装版本容易冲突，配置 PATH 的时候要把自定义 python 路径放在原有路径前面，优先调用自己安装的版本。
常见问题排查表格
| 故障现象 | 主要原因 | 解决办法 |
|---|---|---|
| cmd 输入 python 仍然报错 | 路径填写错误，多写空格或者目录选错 | 重新核对 python.exe 所在文件夹，不要把 python.exe 文件本身填进 PATH |
| python 可用 pip 报错 | Scripts 目录没有加入 PATH | 把 Scripts 子目录路径追加到 Path 变量 |
| 重启终端之后环境变量失效 | 只在临时终端会话设置，没有写入配置文件 | Windows 保存环境变量，maclinux 写入 shell 配置文件并 source 生效 |
| 多个 python 版本冲突 | 多个版本路径都在 PATH，顺序错乱 | 调整 PATH 里面路径排序，想要优先使用的版本放在靠前位置 |
补充注意事项
修改完 Windows 环境变量之后，已经打开的 cmd 或者 powershell 窗口不会自动加载新配置，必须关闭旧窗口重新打开新终端测试。路径里面如果包含中文或者空格，部分老版本 python 会出现异常，尽量选择纯英文无空格的安装目录。不建议随意删除 PATH 里面原有其他程序路径，只做追加新增，避免其他软件命令失效。
【常见问题】
问题 1 python 环境变量设置之后为什么旧 cmd 窗口还是识别不了 python 命令
回答 1 python 环境变量设置完成之后，已经打开的终端窗口不会自动读取更新后的 PATH，必须关闭这个旧 cmd 窗口，重新新开一个命令行窗口，再执行 python 相关验证命令才可以生效。
问题 2 python 环境变量设置只添加主目录为什么 pip 还是不能使用
回答 2 python 环境变量设置除了存放 python.exe 的主目录，还必须单独添加同级的 Scripts 文件夹，pip.exe 就保存在这个 Scripts 目录里面，缺少这个路径系统就无法识别 pip 命令。
问题 3 python 环境变量设置选择用户变量和系统变量有什么区别
回答 3 python 环境变量设置如果写入用户变量，仅当前电脑登录账号可以正常调用 python 命令，如果写入系统变量，本机所有登录用户都可以使用 python，单用户个人电脑推荐直接配置系统变量。
问题 4 多版本 python 共存的时候 python 环境变量设置怎么避免版本混乱
回答 3 多版本 python 共存的时候 python 环境变量设置要调整 PATH 路径排序，把想要默认优先调用的 python 版本目录放在列表靠前位置，系统检索 PATH 是从上到下顺序查找，靠前的版本会优先被调用。
【免责申明】
本文内容仅作为 python 环境变量设置的技术参考，不同操作系统版本不同 python 发行版路径存在差异，操作前请备份原有环境变量，修改系统环境变量属于系统配置操作，误操作可能影响其他软件正常运行，因自行操作产生的系统异常需要自行承担相关风险。