Windows 10/11 设置 Python 环境变量的详细步骤
详细介绍在 Windows 10 与 Windows 11 系统中设置 Python 环境变量的完整步骤，涵盖路径定位、系统属性配置、用户变量与系统变量选择、验证命令及常见问题排查。
python 或 pip 时提示“'python' 不是内部或外部命令，也不是可运行的程序”，通常是因为操作系统的 PATH 环境变量尚未登记 Python 的安装目录。解决这一问题的核心操作，是将 Python 解释器主程序所在的根目录以及包含 pip 工具的 Scripts 脚本目录，准确添加到系统的 Path 变量列表中。本文详细介绍从定位 Python 安装路径、打开系统高级属性、编辑环境变量，到在终端完成验证的全套具体步骤与排查技巧。
一、配置前的必要准备：精准定位 Python 的两个安装目录
在向 Windows 环境变量添加内容之前，首先需要明确目标路径的完整位置。很多用户在配置时只添加了 Python 的主目录，导致后续使用 pip install 安装第三方扩展库后，对应的命令行工具（如 pytest、uvicorn、flake8 等）依然无法直接运行。这是因为 Python 将解释器可执行文件和第三方工具可执行文件分放在了两个不同的目录中。
1. 需要登记的两个核心路径
- 主程序目录（Python 根目录）：该目录下存放着
python.exe和基础动态链接库文件。添加此项后，系统才能在任意终端路径下识别并启动python命令。 - Scripts 脚本目录（子目录）：位于根目录下的
Scripts文件夹中，存放着pip.exe以及后续通过 pip 安装的所有命令行工具。添加此项后，才能在任意位置使用pip、创建虚拟环境或调用工具脚本。
2. 如何找到这两个路径的具体绝对地址
Python 在 Windows 上的安装位置取决于安装时的选项勾选，主要分为以下两种常见情况：
- 默认用户目录安装：若安装时直接点击“Install Now”，通常安装在当前用户的本地应用程序数据目录中，路径结构如下（其中
<用户名>为 Windows 当前登录账户名，版本号视安装版本而定）：
C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\
C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\Scripts\ - 自定义全局目录安装：若勾选了“Install for all users”或手动修改了安装盘符，路径通常类似于：
C:\Program Files\Python312\或C:\Python312\
如果计算机上已经能运行
py（Python 启动器），可以在命令提示符中直接执行以下命令查看 Python 实际路径：py -0p也可以在 Windows 开始菜单中搜索“Python”，在搜索结果的快捷方式上点击鼠标右键，选择“打开文件位置”；在跳转到的快捷方式图标上再次右键并选择“打开文件所在的位置”，文件资源管理器上方地址栏所显示的即为 Python 根目录。点击地址栏即可直接复制该完整路径。
二、Windows 10/11 环境变量配置详细步骤
获取到两个完整路径后，接下来即可进入 Windows 系统属性进行配置。Windows 10 与 Windows 11 在底层的“环境变量”管理面板上完全一致，推荐使用快捷命令直达配置界面。
步骤一：使用快捷命令调出“系统属性”窗口
同时按下键盘上的 Win + R 组合键，屏幕左下方将弹出“运行”对话框。在“打开”输入框中键入以下命令并按下回车键（或点击“确定”）：
sysdm.cpl此命令可以直接调用控制面板的系统属性对话框，省去了在 Windows 10/11 新版设置菜单中多层查找的步骤。
步骤二：切换至“高级”选项卡并打开“环境变量”
在弹出的“系统属性”小窗口中，点击顶部的“高级”标签页。随后在窗口最右下角找到并点击“环境变量(N)...”按钮，系统将弹出环境变量管理主界面。
步骤三：选择并编辑 Path 变量
环境变量窗口分为上下两个独立的列表区域：上半部分为“用户变量”，下半部分为“系统变量”。
- 如果你是这台电脑的日常唯一使用者，或者 Python 安装在个人的
AppData目录下，推荐在上半部分的“用户变量”列表中找到名为Path的条目（不区分大小写）。 - 选中该行后，点击列表下方的“编辑(E)...”按钮，或者直接双击该行，即可进入条目列表编辑窗口。
步骤四：添加 Python 根目录与 Scripts 目录
在弹出的“编辑环境变量”子窗口中，可以看到当前已经配置的所有路径清单。执行以下具体操作：
- 点击右上角的“新建(N)”按钮，列表中将在最末尾生成一个空白输入框。
- 将前面复制好的 Python 根目录绝对路径（例如
C:\Users\Admin\AppData\Local\Programs\Python\Python312\）粘贴进去。 - 再次点击“新建(N)”按钮，将 Scripts 目录绝对路径（例如
C:\Users\Admin\AppData\Local\Programs\Python\Python312\Scripts\）粘贴进去。 - 选中刚刚添加的这两个条目，多次点击右侧的“上移(U)”按钮，将其位置调整到较靠前的位置（建议移至前三位）。这样可以确保在命令行调用时，系统优先匹配该路径，避免被其他安装程序或别名覆盖。
请逐条粘贴纯文本路径，不要在路径末尾额外输入分号（
;）或双引号（"）。Windows 10/11 的列表式编辑器会自动以单行为单位进行隔离，手动追加分号会导致系统将分号视作目录名称的一部分，进而引发路径无法识别。
步骤五：依次点击“确定”保存设置
条目添加完毕后，必须逐层点击确认保存：
- 在“编辑环境变量”窗口中点击底部的“确定”。
- 在“环境变量”窗口中再次点击底部的“确定”。
- 在最外层的“系统属性”窗口中点击“确定”。
必须依次点击这三次“确定”，新修改的配置才会被正式写入 Windows 注册表。如果直接点击红叉关闭或按 Esc 键退出，前面的添加将全部作废。
三、关键机制解析：用户变量 vs 系统变量的差异与选择
许多初学者在配置时常困惑于该改“用户变量”还是“系统变量”。理解两者的关键差异与 Windows 的搜索机制，有助于根据实际需求作出合理选择。
| 对比维度 | 用户变量 (User Path) | 系统变量 (System Path) |
|---|---|---|
| 生效范围 | 仅对当前登录的 Windows 用户生效 | 对整台计算机的所有本地用户及系统服务生效 |
| 权限要求 | 普通用户权限即可修改，无需管理员提升 | 需要拥有本地 Administrator 管理员权限 |
| 典型安装配合 | 安装在当前用户的 AppData 个人目录下 |
安装在公共盘符（如 C:\Program Files\ 或 D:\Python\） |
| PATH 合并与执行次序 | 在系统变量遍历完成后，由系统拼接到后方执行 | 系统优先查找系统变量，排位靠前 |
| 环境隔离度 | 独立隔离，不会影响同一电脑上的其他登录账户 | 全局统一，所有账户共用同一套命令行解释器 |
选择依据建议：
如果 Python 是通过官方安装包默认安装到个人的 %LOCALAPPDATA% 目录下，强烈建议只写入用户变量。因为其他 Windows 账户通常没有权限访问你个人目录下的文件，即使将个人路径写入系统变量，其他账户调用时也会遭遇访问权限拒绝。
反之，如果这台计算机为多人共用，且 Python 明确安装在全局目录（如 C:\Program Files\Python312），则应将其写入系统变量，以便所有用户以及 Windows 后台定时任务直接调度。
四、结果验证与操作效果检查
环境变量保存后，已在运行中的命令提示符或 PowerShell 并不会自动更新环境变量缓存。因此，必须先关闭所有已经打开的终端窗口，然后重新启动一个新的终端窗口，新终端才会读取刚刚更新后的 PATH。
1. 验证 Python 解释器
在新的命令提示符中输入以下命令并回车：
输入命令python --version
终端应返回已安装的 Python 版本号。示例如下：
2. 验证包管理器 pip
输入以下命令检查 pip 及其依赖路径是否正常工作：
输入命令pip --version
终端应输出 pip 的版本号以及对应的库安装路径。示例如下：
3. 排查定位具体调用的可执行文件
如果计算机上存在多个 Python 环境，可以使用 where 命令检查当前命令解析到的实际文件物理路径：
输入命令where python
系统将按 PATH 列表的优先级由高到低，列出所有匹配到的路径。排在第一行的路径即为当前输入 python 时实际启动的文件：
五、常见异常问题与针对性排查
如果完成上述步骤后仍然遇到异常，可对照以下两种高频发生的问题进行定位排查。
问题一：输入 python 命令时自动弹出了微软应用商店 (Microsoft Store)
表现与成因：终端既不报错也不运行 Python，而是直接弹出 Windows 应用商店页面推荐下载 Python。这是 Windows 10 与 11 的内置特性——系统默认在 %LOCALAPPDATA%\Microsoft\WindowsApps 目录下注册了名为 python.exe 和 python3.exe 的零字节别名占位符。若此目录在 PATH 中的排位高于你的真实安装路径，系统就会触发跳转商店。
解决方法（两种方式任选其一，推荐方式 1）：
- 关闭应用执行别名：按下 Win + I 打开 Windows 设置，依次点击“应用” ➔ “高级应用设置” ➔ “应用执行别名”。在列表中找到“应用安装程序 (python.exe)”和“应用安装程序 (python3.exe)”，将右侧的开关全部切换为“关”。
- 提升环境变量排位：重新打开环境变量中的 Path 编辑界面，选中刚刚添加的真实 Python 路径，点击“上移”按钮将其移动到包含
WindowsApps条目的上方。
问题二：配置并保存后，终端依然提示“不是内部或外部命令”
若排查完终端窗口重启后仍提示找不到命令，请对照检查以下三项细节：
- 路径是否存在拼写或包含多余层级：检查填入的路径是否写到了
python.exe本身。Path 环境变量中必须填入文件夹目录（如C:\...\Python312\），而不能直接写成文件的绝对路径（如C:\...\Python312\python.exe）。 - 末尾是否存在特殊字符：检查该行首尾是否不小心复制了不可见空格、换行符或半角分号。如果有，双击该行将首尾多余符号删除。
- 是否未正确保存退出：确认在编辑完毕后连续点击了全部对话框中的“确定”。如果在任何一层点击了“取消”或直接关闭窗口，操作系统不会应用修改。
六、总结与速查清单
Windows 10 与 11 环境下的 Python 环境变量配置本质上十分直接，只要抓住三个要点即可确保一次配置成功：
- 路径要完整：必须同时登记 Python 根目录（服务于
python.exe）和Scripts目录（服务于pip.exe及命令行扩展）。 - 保存要层层确认：编辑完成后依次点击三次“确定”，确保配置写入注册表。
- 测试要开新窗口：配置生效依赖新建终端读取最新的环境缓存，配合关闭 Windows 应用执行别名，即可彻底解决命令找不到或弹出应用商店的问题。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
