安装Python时忘记勾选Add to PATH怎么办

夏知夏

发布时间：2026-10-27 | 5人浏览过

原创

在 Windows 系统安装 Python 时，如果安装界面第一步忘记勾选“Add python.exe to PATH”（或 Add Python 3.x to PATH），不需要卸载重装。你可以通过重新运行安装包点击 Modify 快速补选，或者在 Windows 系统属性中手动添加环境变量。本文将针对这两种操作路径进行具体拆解，并提供配置验证与常见问题排查方法。

一、为什么忘记勾选会导致命令无法识别

在 Windows 操作系统中，命令提示符（cmd）或 PowerShell 本身并不知道 python.exe 存放在硬盘的哪个具体文件夹中。当你输入一个命令（如 python 或 pip）时，系统会按照环境变量 PATH 中记录的文件夹路径列表，从前到后逐个查找是否存在对应的可执行文件。

如果在安装时没有勾选添加环境变量，系统的 PATH 列表中就没有包含 Python 的主安装目录与工具脚本目录（Scripts）。此时直接在终端执行命令，系统检索完全部路径后依然无法匹配，就会出现如下典型报错：

终端报错示例（命令未找到）：

'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。

或者在较新的 Windows 10/11 系统中，直接在终端输入 python 会自动弹跳出微软应用商店（Microsoft Store）的下载页面，这也是未正确配置 PATH 时的常见现象。

图 1：PATH 环境变量如何影响 Windows 命令解析与 Python 启动

二、选择最适合你的解决方式

补救未勾选 PATH 共有两种主流方法：

方法一：重新运行安装程序（推荐）——如果你刚刚完成安装，下载文件夹中的安装包（python-3.x.x-amd64.exe）还在，这种方式最快，图形化点击几步即可自动写入正确路径。
方法二：手动配置系统环境变量——如果安装包已被删除，或者需要精确控制多版本 Python 优先级，手动在 Windows 系统设置中添加目录是标准且彻底的方法。

图 2：针对漏勾选 PATH 场景的两种处理路径选择

三、方法一：重新运行安装包（Modify 修改模式）

官方 Python 安装程序提供了维护模式，支持在不卸载 Python 的前提下修改安装选项：

双击打开原先下载的 Python 官方安装包（例如 python-3.11.x-amd64.exe）。
在弹出的界面中，安装器会识别到该版本已安装，并显示三个选项：Modify（修改）、Repair（修复） 和 Uninstall（卸载）。点击 Modify。
在接下来的“Optional Features”界面，保持默认勾选项，直接点击右下角的 Next。
进入“Advanced Options”界面，找到并勾选 Add Python to environment variables（将 Python 添加到环境变量）。
点击右下角的 Install，等待数秒完成更新。

提示：修改完成后，务必关闭当前所有打开的终端窗口（CMD 或 PowerShell）并重新打开，新配置的环境变量才会生效。

四、方法二：手动在 Windows 系统设置中配置 PATH

如果已经清除了安装包，可以通过 Windows 系统环境变量控制面板直接添加。这需要先定位安装目录，然后写入系统变量。

步骤 1：找到 Python 的实际安装路径

在 Windows 下，Python 默认安装在当前用户的应用数据目录下，或者系统程序目录下：

当前用户默认安装路径：
C:\Users\<你的用户名>\AppData\Local\Programs\Python\Python3xx\
为所有用户安装的路径：
C:\Program Files\Python3xx\

注意：AppData 是系统默认隐藏文件夹。你可以按键盘 Win + R 键唤出运行窗口，输入 %localappdata%\Programs\Python 并回车，文件资源管理器将直接跳转打开该文件夹。进入你的 Python 版本文件夹（如 Python311 或 Python312）。

在这个文件夹中，你会看到 python.exe。同时注意里面还有一个名为 Scripts 的子文件夹（存放 pip.exe）。我们需要记录这两个完整路径：

主程序路径: C:\Users\Administrator\AppData\Local\Programs\Python\Python311
工具脚本路径: C:\Users\Administrator\AppData\Local\Programs\Python\Python311\Scripts

步骤 2：打开环境变量设置窗口

按键盘 Win + R 快捷键打开“运行”窗口，输入命令 sysdm.cpl 并按回车（这将直接打开“系统属性”对话框）。
在弹出的窗口顶部切换到“高级”选项卡。
点击右下角的“环境变量(N)...”按钮。

步骤 3：在 Path 变量中添加两条路径

在“环境变量”窗口中，你可以选择在“用户变量”或“系统变量”下的 Path 列表中添加（如果是个人电脑，建议直接编辑“用户变量”中的 Path）。
选中变量名 Path，点击“编辑(E)...”。
在弹出的编辑界面右侧点击“新建(N)”，将复制好的 Python 主程序路径粘贴进去。
再次点击“新建(N)”，将对应的 Scripts 文件夹路径粘贴进去。
连续点击三次“确定”按钮，保存并关闭所有对话框。

图 3：手动添加 Python 环境变量的核心操作步骤拆解

五、免配置应急方案：使用 Windows 原生 py 启动器

很多初学者不知道，在 Windows 安装 Python 时，即便取消勾选了“Add to PATH”，安装程序通常仍然会默认安装一个名为 Python Launcher（py.exe） 的组件。

这个 py.exe 默认直接放置在系统的 C:\Windows\ 目录下，而该目录本来就在 Windows 的默认 PATH 列表中。因此，你可以在终端中直接输入 py 来代替 python：

使用 py 启动器运行交互环境与脚本（示例）：

# 启动 Python 交互环境
py

# 检查当前默认 Python 版本
py --version

# 运行特定 Python 文件
py main.py

# 调用 pip 工具安装第三方库
py -m pip install requests

如果你手头有紧急任务需要马上运行 Python 脚本，使用 py 启动器可以无需重启电脑或修改环境变量立即投入使用。

六、如何验证配置已经生效

完成上述任一方法配置后，必须通过终端验证两项关键命令：

执行验证命令：

python --version
pip --version

预期终端输出示例（以实际版本为准）：

Python 3.11.8
pip 24.0 from C:\Users\Username\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip (python 3.11)

接着可以使用 where 命令，查看系统当前解析到的具体文件路径：

查询解析路径：

where python

正常输出示例：

C:\Users\Username\AppData\Local\Programs\Python\Python311\python.exe

七、常见问题排查与注意事项

在实际操作中，读者常常遇到“明明加了环境变量但依然报错”或“依然弹出应用商店”的情况，主要由以下三个原因引起：

1. 未关闭旧的终端窗口

Windows 的环境变量在终端启动那一刻载入内存。修改环境变量后，已经打开的 CMD、PowerShell 或 VS Code 内置终端不会同步刷新。必须彻底关闭终端并重新打开，或者直接在 VS Code 中重启终端窗口。

2. 微软应用商店别名（App Execution Aliases）抢占优先级

Windows 10/11 内置了一个指向 Microsoft Store 的占位符别名。当 PATH 配置顺序靠后或未生效时，输入 python 会直接触发该别名打开应用商店。解决方法：

打开 Windows“设置” -> “应用” -> “高级应用设置”。
点击“应用执行别名”（App execution aliases）。
在列表中找到名为“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”的开关，将它们全部关闭（设为 Off）。