Windows 10/11手动将Python添加到PATH环境变量步骤

核心机制：为什么要同时添加两个目录？

很多初学者在手动配置环境变量时，仅将安装目录（例如 Python312）加入 PATH，随后发现虽然能够执行 python 命令，但一使用包管理工具 pip install 就会报出找不到命令的错误。这源于 Windows 环境下 Python 运行架构的天然分工：

• 解释器根目录（Python 主目录）：包含 python.exe、核心动态链接库（DLLs）及标准库。添加此路径后，系统全局均可唤起 Python 执行器运行 .py 脚本。
• 脚本子目录（Scripts 目录）：专用于存放 Python 生态下的所有命令行扩展工具，包括包管理器 pip.exe、虚拟环境创建工具 virtualenv.exe，以及后续通过 pip 安装的第三方 CLI 工具（如 pytest、flake8、jupyter 等）。

因此，手动配置 PATH 必须成对添加这两条路径，二者缺一不可。

第一步：定位 Python 及其 Scripts 的物理安装路径

在编辑环境变量前，必须准确获取本机 Python 的实际安装路径。由于 Windows 系统下安装时权限选项不同（仅为当前用户安装 vs 为所有用户全局安装），路径存储位置存在明显差异。

1. 常见安装路径速查

2. 借助“开始”菜单快捷方式精准倒查路径

如果电脑中安装了多个版本，或者记不清当初自定义的安装位置，可以通过 Windows 开始菜单进行物理追踪：

1. 按下键盘上的 Win 键打开开始菜单，在搜索框中键入 Python。
2. 在出现的 Python 快捷方式（如 Python 3.12 (64-bit)）上点击鼠标右键，选择“打开文件位置”。
3. 此时会打开存放快捷方式的系统文件夹；再次右键选中该快捷方式，点击“属性”。
4. 在“快捷方式”选项卡中的“目标”栏内，即可看到真实的 python.exe 绝对路径。去掉末尾的 python.exe，剩下的即为主目录；在其后追加 \Scripts\ 便是脚本目录。

第二步：在 Windows 10/11 中打开环境变量编辑器

虽然 Windows 10 与 Windows 11 在新版“设置”界面中调整了部分层级，但底层的“环境变量”管理对话框依然沿用了完全一致的系统级组件。推荐使用快捷指令秒级直达，避免在多层界面中反复翻找。

推荐操作：Win + R 一键唤起系统属性

1. 同时按下键盘快捷键 Win + R 呼出“运行”对话框。
2. 在“打开”输入框中输入命令：sysdm.cpl，随后按下回车键或点击“确定”。
3. 系统将立即弹出经典的“系统属性”控制面板窗口。
4. 切换到上方的“高级”选项卡。
5. 点击右下角的“环境变量(N)...”按钮，即可进入变量配置中心。

第三步：将 Python 路径写入 PATH 变量并调整优先级

打开“环境变量”窗口后，可以看到界面被水平分为上下两部分：上半部分是“<当前用户名> 的用户变量”，下半部分是“系统变量”。对于单人日常使用的开发电脑，建议优先修改“用户变量”中的 Path；如果是多用户共享电脑且需要全局通用，可编辑“系统变量”中的 Path。

1. 编辑 Path 条目列表

1. 在“用户变量”（或“系统变量”）列表中，滚动鼠标找到名为 Path（或大写 PATH）的一行，点击选中它。
2. 点击列表下方的“编辑(E)...”按钮。此时会弹出一个按行排列的独立列表窗口。
3. 点击右上角的“新建(N)”按钮，此时光标会落在列表最底部的空白输入行上。
4. 将第一步获取的 Python 根目录路径（如 C:\Users\YourUser\AppData\Local\Programs\Python\Python312\）完整粘贴进去。
5. 再次点击“新建(N)”按钮，将 Scripts 目录路径（如 C:\Users\YourUser\AppData\Local\Programs\Python\Python312\Scripts\）完整粘贴进去。

2. 至关重要的避坑步骤：点击【上移】置顶

这是 Windows 10/11 用户最常踩中的陷阱：微软在较新版本的 Windows 中内置了一个名为 %USERPROFILE%\AppData\Local\Microsoft\WindowsApps 的条目，里面包含了伪装成 python.exe 的 0KB 引导程序。当你在终端输入 python 时，如果系统先检索到了该目录，就会强制弹窗打开微软应用商店（Microsoft Store），诱导用户去商店安装。

因为 Windows 是自上而下顺序扫描 PATH 列表的，只要在前面的路径中命中了可执行文件名，就会立刻终止后续查找。

3. 保存生效规则

完成编辑后，必须依次点击 3 次“确定”按钮（编辑环境变量窗口确定 → 环境变量窗口确定 → 系统属性窗口确定）。如果在任意一层窗口点击了“取消”或右上角的“关闭”，刚才添加的路径都不会被写入注册表。

第四步：重启终端并验证配置是否生效

环境变量的保存是在 Windows 注册表中生效的。对于在修改环境变量之前就已经打开的命令提示符（CMD）或 PowerShell 窗口，它们不会动态更新当前进程的环境变量快照。因此，必须完全关闭已有终端窗口，并重新打开一个全新的命令行窗口进行验证。

1. 验证命令与标准预期输出

按下 Win + R 输入 cmd 打开命令提示符，依次执行以下测试指令：

C:\Users\Admin> python --version
Python 3.12.3

C:\Users\Admin> pip --version
pip 24.0 from C:\Users\Admin\AppData\Local\Programs\Python\Python312\Lib\site-packages\pip (python 3.12)

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

通过 where python 命令可以查看系统搜寻到的所有 python.exe。如果第一行显示的是你手动安装的完整路径，说明优先级调整已经正确生效。

常见问题与排错备忘

Q1: 已经按照教程添加并点击了确定，CMD 依然提示“不是内部或外部命令”？

主要存在三种可能诱因：

1. 终端窗口未重新开启：请务必彻底关闭当前 CMD、PowerShell 或 VS Code 内嵌终端，重新启动终端实例。
2. 路径拼写或格式有误：检查复制的路径中是否误带了中文双引号、多余的空格或错误字符。确保路径形如 C:\Users\Username\AppData\Local\Programs\Python\Python312。
3. 目录实际并不存在：进入文件资源管理器，将配置的路径直接粘贴到地址栏回车，确认是否能正常打开对应文件夹。

Q2: 为什么终端里输入 python 会提示“拒绝访问”？

该现象通常是 Windows 10/11 的“应用执行别名”功能与本地未完全初始化的权限冲突导致的。除了在 PATH 中将 Python 移到最上方之外，还可以直接通过系统设置关闭别名：

打开 Windows “设置” → “应用” → “高级应用设置”（Win10 为“应用和功能”） → “应用执行别名”，在列表中找到“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”，将右侧开关全部拨为“关闭”状态即可彻底解决。