Windows下为Python 3添加环境变量的详细步骤

在 Windows 系统中安装 Python 3 后，如果在命令提示符（CMD）或 PowerShell 中执行 python 或 pip 时系统提示“不是内部或外部命令，也不是可运行的程序”，原因在于系统尚未在全局检索路径（即 Path 环境变量）中登记 Python 解释器及工具集的所在位置。为系统补全这两条关键路径，是让命令行随时调取 Python 运行环境的核心前提。

一、为什么需要配置两个路径：Python 目录与 Scripts 目录

很多初学者在配置 Python 环境变量时，往往只把 Python 的安装主目录复制到 Path 中，随后发现 python 命令可以正常运行，但一旦使用 pip install 安装第三方扩展包时，终端依然提示无法找到命令。这种现象的原因在于 Python 的工具生态采用了分目录管理机制。

Windows 的 Path 环境变量本质上是一个由目录路径构成的线性检索清单。当我们在终端中键入某个指令且没有提供绝对路径时，操作系统会按照清单自上而下逐一检查这些文件夹下是否存在同名的可执行文件（如 .exe、.bat、.cmd）：

• Python 主安装目录：包含 python.exe 与 pythonw.exe 等核心解释器文件。将该目录加入 Path 后，终端才能识别 python 启动指令并运行脚本。
• Scripts 脚本子目录：位于安装目录下的 Scripts 文件夹中，存放着包管理工具 pip.exe、wheel.exe，以及后续安装的诸多第三方命令行工具（例如 flake8.exe、pytest.exe、uvicorn.exe）。若未将该目录添加进 Path，所有全局 CLI 工具都无法被终端直接检索。

图 1：Python 解释器主目录与 Scripts 目录在 Path 检索机制中的对应关系

二、定位 Python 3 与 Scripts 的实际安装路径

在进行手动配置之前，必须准确获取当前计算机上 Python 3 的物理安装路径。根据安装时是否勾选“Install for all users（为所有用户安装）”，默认的安装路径一般分为两种常见形式：

• 当前用户单用户安装（官方安装包默认推荐）：
  C:\Users\<您的Windows用户名>\AppData\Local\Programs\Python\Python312\
  对应的脚本目录为：
  C:\Users\<您的Windows用户名>\AppData\Local\Programs\Python\Python312\Scripts\
• 为所有用户全局安装（自定义或勾选系统级安装）：
  C:\Program Files\Python312\
  对应的脚本目录为：
  C:\Program Files\Python312\Scripts\

py -0p

请将上述获取到的两个完整路径完整复制并临时保存在记事本中，确保其中不包含多余的前后空格。

三、手动添加 Path 环境变量的详细步骤

在 Windows 10 与 Windows 11 中，通过系统设置修改环境变量的操作流程完全一致。请严格按照以下四个步骤进行操作：

步骤 1：打开“系统属性”高级设置

按下键盘快捷键 Win + R 打开“运行”窗口，在输入框中输入命令：

sysdm.cpl

点击“确定”或按下回车键，系统将直接弹出传统的“系统属性”对话框。切换到顶部的“高级”选项卡，然后点击窗口右下角的“环境变量(N)...”按钮。

步骤 2：定位 Path 变量

在打开的“环境变量”窗口中，界面分为上下两部分：

• 用户变量（上半部分）：仅对当前登录的 Windows 账户生效。如果您的电脑并非由您完全独占管理员权限，或者仅希望在当前用户下使用 Python，建议在此处编辑。
• 系统变量（下半部分）：对计算机上的所有 Windows 账户均生效。如果希望所有登录用户都能直接运行 Python，可在系统变量中配置（需要管理员权限）。

在选定的区域（通常为用户变量）中，在变量列表中找到名为 Path（大小写均可）的一项，单击选中后点击下方的“编辑(E)...”按钮；或者直接双击该行。

步骤 3：新建条目并填入两条路径

在弹出的“编辑环境变量”窗口中，右侧有“新建”、“编辑”、“删除”、“上移”、“下移”等按钮：

1. 点击右侧的“新建”按钮，列表最底部会出现一个新的高亮输入行。
2. 将前面记录的 Python 主程序绝对路径（例如 C:\Users\username\AppData\Local\Programs\Python\Python312）粘贴进去。
3. 再次点击“新建”按钮，生成第二个空白输入行。
4. 将 Scripts 目录的绝对路径（例如 C:\Users\username\AppData\Local\Programs\Python\Python312\Scripts）粘贴进去。

步骤 4：连续点击“确定”完成保存

路径输入完成后，请务必依次点击：

1. “编辑环境变量”窗口右下角的“确定”；
2. “环境变量”主窗口右下角的“确定”；
3. “系统属性”窗口右下角的“确定”。

必须连续确认三层对话框，新的环境变量才能正式写入 Windows 注册表。如果直接点击右上角叉号关闭窗口，先前的输入将全部作废。

图 2：Windows 下手动配置 Path 环境变量的四步完整操作流程

四、Path 条目搜索顺序与 WindowsApps 微软商店别名冲突排查

完成上述配置后，不少读者在命令行输入 python 时，可能会遇到一个典型问题：系统没有运行 Python 解释器，而是突然弹出了 Windows 自带的 Microsoft Store（微软应用商店），提示前往商店下载 Python。

产生这一现象的原因是 Windows 10 与 11 内置了名为“应用执行别名（App Execution Aliases）”的机制。在默认情况下，用户的 Path 变量中已经预设了如下路径：

%USERPROFILE%\AppData\Local\Microsoft\WindowsApps

在这个目录下，存放着一个由微软预设的、大小为 0KB 的虚拟 python.exe。当系统在 Path 中从上到下按顺序检索时，如果 WindowsApps 目录排在您刚刚添加的真实 Python 路径之前，操作系统就会优先命中这个 0KB 的引导文件，从而强行唤起应用商店。

图 3：Path 变量自上而下匹配规则与条目优先级调整对比

彻底解决该冲突有两种方式，推荐使用方式一：

• 方式一（调整顺序）：重新回到“编辑环境变量”界面，选中刚添加的 Python 路径与 Scripts 路径，连续点击右侧的“上移”按钮，将其移动到列表的最顶端（或至少位于 WindowsApps 条目之上）。
• 方式二（关闭别名）：进入 Windows“设置” -> “应用” -> “高级应用设置” -> “应用执行别名”，在列表中找到“应用安装程序 (python.exe)”与“应用安装程序 (python3.exe)”，将右侧开关切换为“关”。

五、验证环境变量配置结果与常见排查清单

环境变量修改完毕后，已经打开的命令提示符或 PowerShell 窗口不会自动应用新的环境变量。因为旧终端窗口中运行的进程仅保留启动那一刻的环境变量快照。必须将当前所有打开的终端窗口完全关闭，然后重新打开一个新的终端窗口进行测试。

1. 终端验证指令

在全新打开的 CMD 或 PowerShell 窗口中，依次执行以下三条指令：

python --version
pip --version
where python

在正常情况下，您应当看到类似如下的示例输出：

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

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

C:\Users\username> where python
C:\Users\username\AppData\Local\Programs\Python\Python312\python.exe

图 4：环境配置结果验证与常见问题排除速查总结

2. 常见故障自检速查

• 问题一：python 有效但 pip 报错“不是内部或外部命令”
  检查 Path 列表中是否遗漏了 Scripts 目录。重新进入环境变量设置，补充添加该文件夹的完整绝对路径并保存。
• 问题二：输出的 Python 版本与刚配置的版本不一致
  说明系统中安装过多个 Python 版本（例如 Anaconda、旧版本 Python 或其他开发工具捆绑的环境）。在终端中运行 where python 查看所有匹配路径。返回列表中排在第一行的路径拥有最高优先级。若需使用新版本，进入 Path 编辑器，将目标版本的两行路径“上移”到其他 Python 路径上方。
• 问题三：提示找不到命令且确认路径完全正确
  检查是否在路径条目末尾手误输入了半角分号 ;、全角字符或双引号。删除这些多余符号，确保每一行为干净的磁盘绝对路径，并确认在“系统属性”的所有层级窗口中均点击了“确定”按钮。

完成以上步骤后，Windows 系统即已完整建立起对 Python 3 解释器与 pip 工具集的全局寻址能力，后续在任何路径下的终端窗口中均可随时调用 Python 环境开发与管理项目。