Windows系统安装Python 3.8时怎么勾选Add to PATH
本文详细解答在Windows系统下安装Python 3.8时如何勾选Add to PATH选项,说明具体位置、操作时机、环境变量底层原理、验证方法及漏勾补救方案。
一、勾选 Add to PATH 的具体操作位置
从Python官方网站下载适用于Windows系统的安装包(例如 64 位安装包 python-3.8.10-amd64.exe)后,双击运行进入安装向导。初次接触该界面的读者,往往容易本能地直接点击窗口中最显眼的“Install Now”,从而忽略底部的复选框。正确的操作步骤如下:
- 双击打开安装程序:在Windows桌面或下载文件夹中双击运行
python-3.8.x-amd64.exe。若弹出“用户账户控制”对话框询问是否允许更改设备,选择“是”。 - 注意首屏底部选项:向导首屏展示的是“Install Python 3.8.x (64-bit)”界面。窗口底端包含两个平行的复选框:
- 上方复选框为
Install launcher for all users (recommended),官方默认处于勾选状态。 - 下方复选框为 Add Python 3.8 to PATH,官方默认处于未勾选状态。
- 上方复选框为
- 鼠标单击该复选框:点击“Add Python 3.8 to PATH”前方的方框,使其出现明显的打勾标记([✓])。
- 选择安装方式:完成勾选后,再点击上方的“Install Now”(默认安装至用户AppData目录)或“Customize installation”(自定义选择安装组件及安装路径,如
C:\Python38)。
“Add Python 3.8 to PATH”选项仅在向导首屏可直接设置。一旦点击了“Install Now”开始解压写入文件,向导便无法中途补勾。因此进入界面的第一动作应当是“先看底端勾选,再点上方安装”。
二、为什么要勾选 Add to PATH?环境变量的作用机制
很多初学者疑惑为什么官方要把这个选项做成复选框,并且默认不勾选。要理解其作用,需要了解Windows操作系统查找可执行文件的底层机制。
在Windows系统的命令提示符(CMD)或PowerShell中键入诸如 python 或 pip 等指令时,系统需要知道去哪个文件夹寻找对应的可执行程序(python.exe 或 pip.exe)。Windows的检索逻辑非常直截了当:
- 首先在当前命令提示符所在的当前工作目录下寻找。
- 如果当前目录下没有找到,系统便会依次查阅名为 PATH 的系统环境变量中登记的所有文件夹路径。
- 如果PATH列表中的所有文件夹都遍历完毕仍未找到匹配的文件,终端就会抛出经典错误:
'python' 不是内部或外部命令,也不是可运行的程序或批处理文件。
当在安装阶段勾选了“Add Python 3.8 to PATH”之后,安装程序在完成文件写入的同时,会自动向Windows的PATH环境变量追加两个核心绝对路径:
- Python主程序目录(例如
C:\Users\<用户名>\AppData\Local\Programs\Python\Python38\或C:\Python38\):该目录下存放有python.exe和pythonw.exe,负责响应终端的python命令。 - Scripts工具目录(例如
...\Python38\Scripts\):该目录下存放有包管理工具pip.exe以及后续通过pip安装的各类第三方命令行工具(如virtualenv.exe、flake8.exe等)。
三、安装完成后的验证步骤
安装向导进度条走完后,会出现“Setup was successful”界面(界面底部若出现“Disable path length limit”,建议点击解除Windows对260字符路径长度的限制)。点击“Close”关闭向导。
为确认“Add to PATH”已经确实生效,需打开命令行进行验证。特别注意:必须在安装完成后打开一个全新的命令提示符窗口,因为在安装前就已经打开的旧CMD窗口不会自动刷新继承系统最新的环境变量。
1. 验证 Python 解释器
按下键盘快捷键 Win + R,在运行窗口中输入 cmd 并回车,在黑色窗口中键入以下命令:
C:\Users\Admin> python --version
# 预期输出示例:
Python 3.8.10
如果成功打印出 Python 3.8.10(或其他具体的3.8子版本号),说明Python主程序已被命令行正确识别。
2. 验证包管理工具 pip
继续在终端中输入验证pip的命令:
C:\Users\Admin> pip --version
# 预期输出示例:
pip 20.0.2 from C:\Users\Admin\AppData\Local\Programs\Python\Python38\lib\site-packages\pip (python 3.8)
若能够显示pip版本号及其指向Python 3.8路径,表明 Scripts 目录也已成功注入PATH中。
3. 查询可执行文件所在路径
在Windows中还可以使用 where 命令查看系统当前解析的具体物理文件位置:
C:\Users\Admin> where python
# 预期输出示例:
C:\Users\Admin\AppData\Local\Programs\Python\Python38\python.exe
四、如果安装时忘记勾选,如何补救?
如果在安装过程中一时手快直接点击了“Install Now”,导致没有勾选“Add to PATH”,完全不需要卸载重装系统,可通过以下两种方式快速补救。
方法一:重新运行安装包进行修复(推荐,简单防错)
这是最推荐的方法,不仅免去手动输入长路径可能导致的拼写错误,还能确保Scripts路径一并写入:
- 找到最初下载的
python-3.8.10-amd64.exe安装包,再次双击运行。 - 此时安装程序检测到已安装Python 3.8,会弹出维护界面,显示三个选项:Modify(修改)、Repair(修复)、Uninstall(卸载)。
- 点击 Modify,在弹出的“Optional Features”功能选项页面直接保持默认,点击右下角 Next。
- 进入“Advanced Options”高级选项页面,在选项列表中勾选 Add Python to environment variables(将Python添加到环境变量),然后点击 Install。
- 安装程序执行更新后提示成功,关闭向导。新开CMD窗口即可正常使用。
方法二:通过Windows高级系统设置手动添加环境变量
若原安装包已被删除或希望直接通过系统设置配置,可以按以下步骤手动添加:
- 按下快捷键
Win + R,在运行对话框中输入sysdm.cpl并回车,直接打开“系统属性”。 - 在顶部切换到 高级 标签页,点击右下方的 环境变量 按钮。
- 在打开的环境变量窗口中,在“用户变量”或“系统变量”区域中找到名为
Path的变量,选中后点击 编辑。 - 在弹出的编辑界面中点击右侧的 新建 按钮,分别添加两条路径(以默认用户安装目录为例,需替换其中的用户名):
C:\Users\<用户名>\AppData\Local\Programs\Python\Python38\C:\Users\<用户名>\AppData\Local\Programs\Python\Python38\Scripts\
- 连续点击三次 确定 保存设置,关闭并重新打开命令提示符窗口进行验证。
在某些Windows 10/11系统上,即使配置了PATH,在CMD输入 python 却自动弹出了应用商店下载页面。这是由于Windows自带的“应用执行别名”优先级高于自定义路径所致。解决方法:打开Windows「设置」→「应用」→「高级应用设置」→「应用执行别名」,将其中“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”两个开关关闭即可。
五、总结与配置速查清单
正确勾选“Add Python 3.8 to PATH”是Windows环境下配置Python开发环境最关键的第一道工序。通过在安装首屏将该选项设为有效,能够规避绝大多数初学者遭遇的“命令无法识别”和第三方模块无法安装的困扰。下表汇总了安装时的核心要点:
| 配置项目 | 具体要求 / 推荐设置 | 注意事项 |
|---|---|---|
| 勾选时机 | 运行安装包后弹出的首个对话框 | 必须在点击“Install Now”或“Customize”之前完成 |
| 选项名称 | Add Python 3.8 to PATH | 位于窗口底部靠右位置,默认无打勾标记 |
| 配套选项 | Install launcher for all users | 建议保持默认勾选,提供 py.exe 启动器支持 |
| 写入内容 | Python主程序根目录 + Scripts子目录 | 确保 python.exe 和 pip.exe 均可被系统识别 |
| 验收测试 | 新开CMD运行 python --version 与 pip --version |
已打开的旧CMD不会生效,必须新建终端窗口 |
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









