Win10系统Python环境变量配置图文教程

在 Windows 10 系统中安装 Python 后，如果直接在命令提示符窗口输入 python 或 pip 提示“不是内部或外部命令”，说明系统的环境变量中尚未加入 Python 的可执行文件路径。本文通过梳理核心路径、打开系统环境变量面板、将路径注册到 Path 变量以及最终的控制台验证，完整演示手动配置环境变量的规范流程。

一、为什么需要手动配置 Python 环境变量

Windows 系统在执行用户在命令行敲入的指令时，并不会全盘扫描硬盘寻找对应的程序，而是首先在当前工作目录下查找，随后逐一扫描系统变量 Path 中预先登记的文件夹目录。

配置环境变量的实质，就是告诉 Windows 系统：“当我在任意路径下敲击 python 时，请去这几个固定文件夹里寻找 python.exe，敲击 pip 时去寻找安装工具”。如果没有完成这项登记，命令行就无法识别该指令，导致各类开发工具、脚本或自动化任务无法正常调用 Python 解释器。

图 1：Windows 命令行寻找并执行 Python 指令的检索机制

二、查找 Python 安装路径与 Scripts 目录

进行环境变量配置前，必须先获取本机的确切安装文件夹。配置过程必须同时包含两个路径：一个是包含 python.exe 的根目录，另一个是包含 pip.exe 的 Scripts 目录。

常见默认安装位置

安装 Python 时如果使用的是标准官方安装包，依据安装选项的不同，通常会位于以下两个目录之一（以 Python 3.11 为例）：

• 单用户默认路径（勾选了 Install for just me）：
  C:\Users\你的Windows用户名\AppData\Local\Programs\Python\Python311
• 全用户自定义路径（勾选了 Install for all users 或手动指定）：
  C:\Program Files\Python311 或自定义盘符路径（如 D:\Python311）

快速定位真实路径的技巧

如果此前已经在系统菜单生成了快捷方式，可以按下键盘上的 Win 键打开“开始”菜单，找到“Python 3.x”，在图标上右键选择“更多” > “打开文件位置”。在打开的文件夹中，继续对着 Python 快捷方式右键并选择“属性”，面板中“目标”一栏所指的文件夹去除可执行文件名后，即为根路径。

图 2：环境变量 Path 中必须同时登记的两个目录及其对应分工

三、进入 Win10 环境变量设置界面

在 Windows 10 中进入环境变量面板主要有两种规范方式：

1. 运行窗口直达（最快）：按下键盘组合键 Win + R 呼出“运行”对话框，输入 sysdm.cpl 并按下回车，系统将直接弹出“系统属性”窗口。
2. 系统设置入口：在桌面上找到“此电脑”图标，单机鼠标右键选择“属性”，在打开的“关于”页面右侧（或下方）找到并点击“高级系统设置”。

在打开的“系统属性”弹窗中，切换到“高级”标签页，点击最右下方的“环境变量(N)...”按钮，即可进入环境变量管理中心。

四、将路径添加到 Path 环境变量的操作步骤

进入“环境变量”窗口后，可以看到上下两个区域：上半部分是“用户变量”，下半部分是“系统变量”。

如果当前电脑仅供个人使用，修改“用户变量”或“系统变量”均可生效；如果电脑有多个 Windows 账户，建议将路径添加到下半部分的“系统变量”中，确保所有登录用户都能正常使用。

图 3：在 Win10 的 Path 列表中新建并置入两个目录的具体交互位置

具体执行操作按顺序分为以下四步：

1. 在“系统变量”区域中向下滚动，选中名为 Path 的变量名，点击下方的“编辑(E)...”按钮。
2. 在右侧弹出的“编辑环境变量”子窗口中，点击右上方的“新建(N)”按钮，列表末尾会出现一个空白输入光标。
3. 粘贴或输入之前记录的 Python 根安装目录（如 D:\Python311\），输入完成后按回车键确认。
4. 再次点击“新建(N)”按钮，将包含 pip 的 Scripts 目录（如 D:\Python311\Scripts\）粘贴进去并按回车确认。
5. 连续点击三次各个层级面板下方的“确定”按钮保存变更。注意：若未点击“确定”而是直接关闭窗口，配置不会保存。

五、验证环境变量是否配置成功

修改系统环境变量后，已经处于打开状态的 CMD 窗口不会自动更新上下文，必须关闭旧窗口并重新打开新的命令提示符窗口才能加载最新配置。

按 Win + R 键输入 cmd 打开新的终端，分别执行以下两个命令检测输出：

python --version

如果配置正确，终端会直接输出当前安装的 Python 版本号：

Python 3.11.8

pip --version

终端会输出 pip 版本以及该 pip 工具所指向的安装路径：

pip 24.0 from D:\Python311\Lib\site-packages\pip (python 3.11)

六、配置后仍无法正常调用的排查清单

如果严格按上述步骤配置后依然报错，可按以下表格列出的典型问题进行针对性核对：

图 4：Win10 系统 Python 环境变量配置核心环节总结