Windows安装Python怎么勾选Add to PATH环境变量

Theo

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

原创

详细介绍在Windows系统中安装Python时如何勾选Add to PATH选项，解释该选项在系统中的运行机制、安装遗漏后的两套补救方案以及命令行验证和常见故障排查方法。

在 Windows 官方安装程序启动的初始界面底部，有一个名为 Add python.exe to PATH（早期版本显示为 Add Python 3.x to PATH）的复选框。该选项默认处于未勾选状态。勾选它的核心作用是将 Python 解释器与 pip 工具所在的物理路径自动写入 Windows 系统的 PATH 环境变量中，使用户后续在任意命令提示符（CMD）或 PowerShell 窗口中直接输入 python 和 pip 即可启动程序。

Windows安装Python怎么勾选Add to PATH环境变量 — 图 0：Windows 环境下 Python 安装向导与 PATH 环境变量联动导览

一、安装向导界面的具体位置与勾选步骤

从 Python 官方网站（python.org）下载 Windows 版本的 64 位可执行安装包（例如 python-3.12.x-amd64.exe）。双击运行安装包后，系统会展示安装向导的首页。此时请注意界面的布局，切勿直接点击界面中间醒目的“Install Now”按钮。

在该初始界面的最下方，通常排列着两个复选框：

Use admin privileges when installing py.exe（为所有用户安装启动器，建议保留勾选）。
Add python.exe to PATH：此项即为添加环境变量的关键选项。在旧版安装包（如 Python 3.7 / 3.8）中，该文本标注为 Add Python 3.x to PATH，而在新版（如 Python 3.9 至 3.13）中统一写作 Add python.exe to PATH。必须手动点击该复选框，使其呈现打勾状态 [✓]。

完成底部勾选后，再根据需求选择安装模式：若接受默认安装路径（通常安装在当前用户的 AppData 目录），直接点击“Install Now”；若希望自定义安装路径（例如指定到 D:\Python312），则点击“Customize installation”，进入后续步骤指定目录并完成安装。

注意事项：很多初次安装 Python 的用户习惯性直接点击“Install Now”，安装完成后在终端键入命令却报错。安装程序在默认策略下不会主动勾选此选项，因此在首屏界面的第一动作应当是移到下方完成勾选。

二、为什么一定要勾选“Add python.exe to PATH”

PATH 是 Windows 操作系统中的一项核心环境变量。当用户在终端键入一个程序名（如 python）且未提供完整路径时，Windows 会遵循固定的查找逻辑：首先在当前工作目录下查找对应文件；如果找不到，便会依次检索系统与用户 PATH 变量中登记的所有文件夹路径。

勾选与未勾选 Add to PATH 的实际运行差异如下：

已勾选状态：安装程序会自动将两个重要目录加入用户的 PATH 变量中：一是 Python 根目录（包含 python.exe 主程序），二是其子目录 Scripts（包含第三方包管理工具 pip.exe 和其它命令行可执行脚本）。因此，无论终端当前处于哪个磁盘驱动器或工作目录，键入 python 或 pip 均能被系统立即解析执行。
未勾选状态：操作系统无法获知 Python 安装在哪个文件夹中。在命令行中键入 python 时，终端将直接返回错误信息：'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。此时若要运行 Python，用户必须在命令前输入长达数十个字符的绝对路径（例如 C:\Users\用户名\AppData\Local\Programs\Python\Python312\python.exe），给日常开发带来极大不便。

三、安装时遗漏勾选的两种补救方案

如果此前已经完成了安装，但在安装时忘记了勾选该复选框，完全无需卸载软件重新安装。可以采用以下两种行之有效的方案补齐配置。

方案一：重新运行安装包选择 Modify（最简方案）

如果下载的原安装包文件（python-3.x.x-amd64.exe）还在电脑中，这是最不容易出错的修复方式：

双击重新运行该安装程序，向导会识别到已安装 Python，并弹出维护选项界面：Modify（修改）、Repair（修复）、Uninstall（卸载）。
点击 Modify 按钮。
在随后的“Optional Features”功能选项页中，各项保持默认勾选，直接点击右下角的 Next。
进入“Advanced Options”（高级选项）页面，在此界面中勾选 Add Python to environment variables（将 Python 添加到环境变量），然后点击 Install。
等待进度条执行完毕，安装程序便会自动把缺失的 PATH 变量补齐写入系统注册表。

方案二：手动在 Windows 系统设置中配置 PATH

如果安装程序已删除或处于离线受限环境，可以通过系统属性面板手动添加：

按快捷键 Win + R 打开运行窗口，输入 sysdm.cpl 后按回车，快速调出“系统属性”面板。
在弹出的窗口顶部切换到“高级”选项卡，点击底部的“环境变量”按钮。
在“用户变量”或“系统变量”区域中找到名为 Path 的变量项，单击选中后点击“编辑”。
在编辑环境变量窗口右侧点击“新建”，依次添加以下两条路径（请将路径中的用户名与版本号替换为您计算机上的实际安装路径）：

需添加的典型路径示例

C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\
C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\Scripts\

添加完成后，逐层点击各个窗口的“确定”按钮保存变更并退出。

四、验证环境变量生效与常见问题排查

无论是通过安装向导自动勾选还是后续手动配置，修改环境变量后都必须进行验证，以确保终端环境正常工作。

1. 正确验证命令

关键前提：如果此前已经打开了命令提示符（CMD）或 PowerShell 窗口，必须将其完全关闭并重新打开。因为已经处于运行状态的终端进程无法动态读取新写入的环境变量。

在新终端窗口中依次输入以下验证指令：

终端测试命令

python --version
pip --version

预期正确输出示例

Python 3.12.8
pip 24.3.1 from C:\Users\Username\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)

2. 常见问题：输入 python 自动跳转 Microsoft Store

在 Windows 10 与 Windows 11 系统中，许多用户在配置完环境变量后输入 python，终端不仅没有进入交互式命令行，反而弹出了微软应用商店（Microsoft Store）的 Python 页面。这是由于 Windows 默认预设了“应用执行别名”所导致的劫持现象。

排查与消除方法：

打开 Windows“设置”（快捷键 Win + I）。
进入“应用” -> “高级应用设置” -> 点击“应用执行别名”（部分旧版本系统路径为“应用和功能” -> “应用执行别名”）。
在别名列表中找到名称为 应用安装程序 (python.exe) 和 应用安装程序 (python3.exe) 的开关，将其全部切换为“关”。
在终端中运行 where python 命令进行复查。此时输出的第一行应指向本地实际安装的物理路径，而不再指向 WindowsApps 目录。

总结

在 Windows 下安装 Python 时，首屏底部的 Add python.exe to PATH 是连接解释器与全局命令行的关键纽带。养成安装时立即勾选该选项的习惯，能够直接避免后续的路径找不到报错与工具链调用失败。即使在初次安装时不慎漏选，通过原安装程序的“Modify”模式或手动配置系统 Path 变量，也能在数分钟内平滑恢复开发环境的完整功能。