Win10手动添加Python环境变量的详细步骤

一、配置前的必要准备：确认两个核心路径

在手动配置环境变量前，必须先在本地计算机中定位出 Python 的两个真实目录。很多读者在配置时仅添加了 Python 的安装根目录，导致虽然能正常运行 python，但后续通过 pip 安装第三方库或执行脚手架命令时依然报找不到命令。因此，完整的配置需要包含两个路径：

• 主程序目录：存放 python.exe 和 pythonw.exe 等核心可执行文件，用于在终端任意路径唤醒 Python 解释器。
• Scripts 脚本目录：存放 pip.exe、wheel.exe 以及后续安装的命令行工具（如 flake8、pytest 等），用于管理模块依赖。

常见默认路径与查找方法

不同安装方式对应的目录结构略有差异：

• 官方安装包默认路径（当前用户）：
  C:\Users\<您的用户名>\AppData\Local\Programs\Python\Python311\
C:\Users\<您的用户名>\AppData\Local\Programs\Python\Python311\Scripts\
  注：AppData 为隐藏文件夹，需在文件资源管理器“查看”菜单中勾选“隐藏的项目”即可查看。
• 自定义安装路径（例如安装在C盘或D盘根目录）：
  C:\Python311\
C:\Python311\Scripts\

如果您不确定当前 Python 安装在哪个位置，可以按下 Win + S 搜索“Python”，在搜索结果中的“Python 3.x”上右键选择“打开文件位置”；进入快捷方式所在文件夹后，再次右键该快捷方式并选择“属性”，在“目标”一栏中即可看到真实的安装目录。

二、在 Win10 中打开环境变量设置界面

Windows 10 系统打开环境变量窗口有两种最常用且稳定的途径，推荐优先使用快捷命令方式，能够一键直达，免去层层翻找菜单的麻烦：

方法一：快捷键直接唤起（推荐）

1. 按下键盘快捷键 Win + R 呼出“运行”对话框。
2. 在输入框中准确输入命令 sysdm.cpl，随后按下回车键或点击“确定”。
3. 系统将直接弹出“系统属性”对话框。
4. 在弹出的对话框顶部点击切换至“高级”选项卡。
5. 点击右下角的“环境变量(N)...”按钮，即可进入变量配置管理界面。

方法二：通过文件资源管理器此电脑进入

1. 双击桌面“此电脑”图标，或按下 Win + E 打开文件资源管理器。
2. 在左侧导航窗格中找到“此电脑”，右键点击并选择“属性”。
3. 在弹出的系统设置页面右侧（或相关设置中），点击“高级系统设置”。
4. 进入“系统属性”窗口的“高级”选项卡，点击右下角“环境变量(N)...”。

三、向 Path 变量添加目录并调整优先级

打开“环境变量”窗口后，界面分为上下两部分：上方是“当前用户的用户变量”，下方是“系统变量”。

用户变量与系统变量的选择

具体的条目新建与保存步骤

1. 在“系统变量”区域中找到名为 Path 的条目，单击选中后点击“编辑(E)...”（或直接双击该行）。
2. 此时系统会打开“编辑环境变量”窗口，该窗口以条目清单形式逐行展示当前所有环境变量。
3. 点击右上角的“新建(N)”按钮，光标会自动定位到列表最底部的空白输入行。
4. 将准备好的 Python 主安装目录粘贴进去（例如 C:\Python311\ 或 C:\Users\Admin\AppData\Local\Programs\Python\Python311\）。
5. 再次点击“新建(N)”按钮，生成新的空白行。
6. 将 Scripts 目录路径粘贴进去（例如 C:\Python311\Scripts\）。
7. 调整优先级（关键防坑操作）：选中刚新建的两个条目，点击右侧的“上移(U)”按钮，将它们移动到靠前的位置（建议移至前两行或紧随系统核心路径之后）。这一步能有效防止后续出现 Windows 10 默认自带的 WindowsApps 替身拦截。
8. 逐层确定保存：必须依次点击【编辑环境变量】窗口的“确定”、【环境变量】窗口的“确定”、以及【系统属性】窗口的“确定”（共点击三次确定）。若中途直接点击关闭或取消，修改将不会写入 Windows 注册表。

四、打开新终端验证与配置生效检查

第一步：验证 Python 解释器

按下 Win + R，输入 cmd 回车，打开全新的命令提示符，执行以下命令：

python --version

正常输出示例：

Python 3.11.5

若输出了您安装的 Python 版本号，说明主安装目录配置正确。

第二步：验证 pip 包管理工具

在同一个命令提示符窗口中，执行以下命令：

pip --version

正常输出示例：

pip 23.2.1 from C:\Users\Admin\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip (python 3.11)

若输出了 pip 的版本号以及对应 Python 目录的绝对路径，说明 Scripts 目录配置成功。

第三步：查看命令实际指向的路径（确认优先级）

如果您电脑中安装了多个 Python 版本，或者想核对系统到底调用的哪个位置的执行文件，可以运行 where 命令排查：

where python

输出示例：

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

系统会自上而下匹配并优先调用第一行路径。只要您手动添加的目录排在首位，即可确保始终调用真实的 Python 环境。

五、常见问题深度排查

1. 为什么在 CMD 中输入 python 会自动弹起应用商店？

这是 Windows 10 系统内置的“应用执行别名”机制。Windows 10 默认在系统目录中放置了名为 python.exe 和 python3.exe 的引导替身，如果它们在 Path 中的优先级高于您实际安装的 Python，系统就会自动唤起微软商店引导下载。

彻底根治方法有两种：

• 方法 A（推荐）：在“编辑环境变量”窗口中，选中您的 Python 路径，点击“上移”按钮，将其移动到 %USERPROFILE%\AppData\Local\Microsoft\WindowsApps 之上。
• 方法 B：点击 Windows 开始菜单 -> 设置 -> 应用 -> 应用和功能 -> 点击“应用执行别名”，在列表中将“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”两个开关彻底关闭。

2. 路径填完后 pip 依然报错无法使用？

请打开资源管理器进入 Python 安装目录，确认里面是否存在名为 Scripts 的文件夹，并进入该文件夹核对是否存在 pip.exe。若该文件夹为空或不存在 pip，说明安装 Python 时未勾选 pip 组件。可以通过在终端执行以下内置修复命令重新安装 pip：

python -m ensurepip --default-pip

安装完成后，再次确保该 Scripts 目录已被加入到系统的 Path 中即可。

3. 路径字符串格式细节注意

在 Win10 的“编辑环境变量”图形界面中，每一个新建的条目都是独立的单行输入，行末不需要像老版 Windows 7 一样手动输入英文分号 ;。若误在行末增加了分号，系统会将分号当作路径名称的一部分，从而导致路径解析失效。