Windows 10/11 手动配置 Python 环境变量的详细步骤

图 1：Windows Path 环境变量检索与 Python 组件调用链路概览

一、准备工作：获取 Python 的两个关键路径

配置 Windows 环境变量时，很多初学者仅添加了 Python 的安装主目录，导致后续在终端中可以使用 python 运行脚本，但调用 pip 安装第三方库时依然报错“'pip' 不是内部或外部命令”。要使 Python 运行环境完全正常，必须同时配置以下两个目录：

• Python 主安装目录：存放 python.exe、pythonw.exe 以及标准库的核心动态链接库（如 python312.dll），负责执行 Python 代码。
• Scripts 脚本目录：位于主目录内部的 Scripts 子文件夹，存放 pip.exe、wheel.exe 以及后续通过 pip 安装的所有命令行工具（例如 pytest、flake8、uvicorn 等）。

常见默认安装路径参考

根据安装 Python 时选择的安装模式，路径通常分为“当前用户安装”与“所有用户安装”两种形态：

图 2：Windows 10/11 手动配置环境变量完整工程工序

二、进入环境变量设置窗口的具体操作

无论是 Windows 10 还是 Windows 11，都可以通过最快捷的系统运行命令直达设置窗口，避免在复杂的系统设置层级中反复寻找：

1. 按下组合键 Win + R 唤出“运行”窗口，在输入框中输入 sysdm.cpl，点击“确定”或按回车键。该命令会直接打开“系统属性”面板。
2. 在弹出的“系统属性”窗口中，切换到顶部的“高级”选项卡。
3. 在“高级”选项卡底部，点击“环境变量(N)...”按钮，系统将弹出“环境变量”独立配置窗口。

在环境变量窗口中，界面被划分为两部分：上半部分为“<当前用户> 的用户变量”，下半部分为“系统变量”。如果这台电脑主要供您个人使用，建议直接在“用户变量”中编辑；如果需要本机上的所有 Windows 账户共享该 Python 环境，则需要在“系统变量”中进行修改（需要管理员权限）。

三、在 Path 变量中添加两条路径并调整排序

找到对应区域中的 Path 变量（部分显示为 PATH），双击该变量，或者选中它后点击下方的“编辑(E)...”按钮，进入“编辑环境变量”列表界面。

1. 点击列表右侧的“新建(N)”按钮，此时列表最下方会出现一个空白光标行。
2. 将前面复制的 Python 主安装目录绝对路径粘贴进去（例如 C:\Users\Admin\AppData\Local\Programs\Python\Python312\）。
3. 再次点击“新建(N)”按钮，将 Scripts 目录的绝对路径粘贴进去（例如 C:\Users\Admin\AppData\Local\Programs\Python\Python312\Scripts\）。
4. 选中刚添加的 Python 路径，点击右侧的“上移(U)”按钮，将其移动到列表的上半区域，确保优先级高于系统默认预置的应用路径。
5. 依次点击当前窗口的“确定”、环境变量窗口的“确定”、系统属性窗口的“确定”。必须逐层点击确定保存，若直接点击右上角关闭按钮将不会保存修改。

图 3：环境变量编辑界面与本地物理文件目录映射拓扑

四、解决 Windows 10/11 应用执行别名冲突（避免跳转应用商店）

在 Windows 10（较新版本）和 Windows 11 中，系统默认在 %LOCALAPPDATA%\Microsoft\WindowsApps 目录下放置了名为 python.exe 和 python3.exe 的 0 KB 快捷存根。该存根的作用是当用户尚未安装 Python 时，在命令行输入 python 会引导打开微软商店。

如果手动配置 Path 后未调整顺序，或者该别名优先级仍高于实际安装路径，终端在执行 python 时会继续被该存根拦截，弹出 Microsoft Store。彻底关闭该冲突的操作如下：

1. 按下键盘 Win + I 打开 Windows“设置”应用。
2. 在左侧导航栏选择“应用”，右侧选择“高级应用设置”（Windows 10 为“应用和功能”）。
3. 点击“应用执行别名”（App execution aliases）。
4. 在列表中找到名为“应用安装程序 - python.exe”与“应用安装程序 - python3.exe”的条目，将其右侧的开关切换为“关”。

图 4：WindowsApps 别名劫持机制与路径优先级修复对比

五、新开终端验证配置结果

核心注意事项：修改环境变量后，之前已经打开的命令提示符（CMD）或 PowerShell 窗口不会自动加载新变量。必须彻底关闭旧终端，重新打开一个新的终端窗口进行测试。

按下 Win + R，输入 cmd 回车，依次运行以下三组指令核对运行结果：

1. 验证 Python 解释器

python --version

示例预期输出：Python 3.12.2（输出实际安装的具体版本号，不再报错且不打开商店）。

2. 验证包管理器 pip

pip --version

示例预期输出：pip 24.0 from C:\Users\Admin\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)。

3. 检查执行程序解析路径（确认优先级）

where python

示例预期输出：

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

在 where python 的输出结果中，排在第一行的必须是您的实际安装路径。Windows 按照从上至下的顺序调用首个命中的可执行文件，第一行为实际路径即代表解析优先级正确。

图 5：终端核验命令判定矩阵与故障排查状态机

六、常见问题排查与速查清单