Windows 10/11怎么添加Python环境变量

栗子
栗子
发布时间:2026-11-21 | 3人浏览过
原创

详细讲解在Windows 10与Windows 11系统中手动添加Python环境变量的完整步骤。包含Python主目录与Scripts目录的定位、Path变量配置、终端验证命令以及应用商店别名拦截等常见问题的排查方法。

在 Windows 10 或 Windows 11 中添加 Python 环境变量,核心是将 Python 安装目录及其下属的 Scripts 目录两个路径追加到系统的 Path 变量中。配置完成后,无论在任何文件夹位置打开命令提示符(CMD)或 PowerShell,系统都能直接识别并运行 python 解释器与 pip 包管理工具。

一、为什么必须配置环境变量与两个关键路径

当你在命令提示符中敲入 python 并回车时,Windows 并不是凭借直觉去寻找软件,而是严格按照系统内部设定好的 Path 环境变量列表,逐个文件夹按顺序搜寻是否存在名为 python.exe 的可执行文件。如果各个目录里都找不到,终端就会抛出常见的提示:“'python' 不是内部或外部命令,也不是可运行的程序或批处理文件”。

很多初学者在手动配置环境变量时,容易产生一种误解:以为只要把 python.exe 所在的根文件夹放进 Path 就大功告成了。这种配置看似让 python 命令正常跑了起来,但在随后的开发过程中,一旦尝试使用 pip install 安装第三方库,或者直接调用由第三方库生成的命令行工具(如 pytest、flake8、uvicorn 等)时,系统依然会报错找不到命令。

原因就在于 Python 采用了双层分工结构:Python 解释器本身存放在安装根目录,而通过 pip 下载安装的控制台可执行脚本、包装程序以及 pip.exe 本身,都被统一存放在安装目录下的 Scripts 文件夹中。因此,完整的环境变量必须同时包含这两个独立的路径。

Windows 10/11怎么添加Python环境变量
图 1:Windows Path 变量检索机制与 Python 双核心路径匹配关系

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

在进入系统设置之前,必须准确获取电脑上 Python 到底装在哪个具体目录下。根据安装时的勾选项不同,Windows 系统上常见的 Python 安装位置一般有两种情况:

1. 当前用户独立安装(官方安装包默认路径)

如果在安装时没有勾选“Install for all users”,Python 会默认安装在当前用户的应用数据目录下。其路径结构固定如下(需将 <用户名> 替换为你自己的 Windows 登录用户名,版本号如 Python312 视实际安装版本而定):

C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\
C:\Users\<用户名>\AppData\Local\Programs\Python\Python312\Scripts\

注意:AppData 文件夹在 Windows 文件资源管理器中默认处于隐藏状态。如果你需要手动进入查看,可以在文件资源管理器顶部的“查看”菜单中勾选“隐藏的项目”,或者按 Win + R 键输入 %localappdata%\Programs\Python 并回车直接直达该目录。

2. 全体用户安装或自定义路径

如果安装时勾选了全员安装,或者手动修改了安装目标文件夹,路径通常较为直观,例如:

C:\Program Files\Python312\
C:\Program Files\Python312\Scripts\
# 或者自定义的分区路径:
D:\Python\Python312\
D:\Python\Python312\Scripts\
💡 快速定位路径技巧

如果不确定具体路径,可以在“开始”菜单搜索“Python”,在搜索结果中的“Python 3.x”快捷方式上点击鼠标右键,选择“打开文件位置”;接着在打开的文件夹中再次右键快捷方式选择“属性”,弹窗中的“目标”字段所在目录即为 Python 的主安装路径。

三、在 Windows 10/11 中手动添加环境变量的完整步骤

Windows 10 和 Windows 11 的底层系统架构一致,配置界面完全相同。推荐使用系统快捷命令直接调出配置窗口,避免在复杂的“设置”层级中反复寻找。

Windows 10/11怎么添加Python环境变量
图 2:Windows 10/11 手动配置 Python 环境变量步骤图解
  1. 快捷调出“系统属性”: 按下键盘上的 Win + R 快捷键,调出“运行”对话框,输入 sysdm.cpl,然后按下回车键或点击“确定”。这会直接打开经典的“系统属性”窗口。
  2. 切换并打开“环境变量”: 在“系统属性”面板顶部切换到“高级”选项卡,然后点击右下角的“环境变量(N)...”按钮。
  3. 选择变量作用域(用户变量 vs 系统变量): 在弹出的环境变量窗口中,分为上下两个区域:
    • 用户变量(上方):仅对当前登录的 Windows 用户生效。如果电脑主要是你个人使用,推荐直接添加到用户变量中的 Path,安全性更高,不会影响同台电脑的其他系统用户。
    • 系统变量(下方):对这台电脑上的所有用户和后台服务都生效。如果多账户共享设备,或者需要某些以系统身份运行的定时任务调用 Python,则应修改系统变量中的 Path。
    选中你所选择区域中的 Path(或 PATH)条目,点击“编辑(I)...”按钮(或者直接双击该行)。
  4. 新增 Python 路径: 在弹出的“编辑环境变量”窗口中,点击右侧的“新建(N)”按钮,光标会落在最后一行空白处,将刚才确认的 Python 主目录粘贴进去;紧接着再次点击“新建(N)”按钮,将下属的 Scripts 目录也粘贴进去。

    例如两行独立内容分别为:
    C:\Users\Admin\AppData\Local\Programs\Python\Python312
    C:\Users\Admin\AppData\Local\Programs\Python\Python312\Scripts

  5. 层层确认并保存: 在“编辑环境变量”窗口中点击“确定”;在“环境变量”窗口中再次点击“确定”;最后在“系统属性”窗口中点击“确定”。必须完成这三次确认,所作的修改才会被 Windows 写入注册表。

四、验证环境变量是否添加成功

完成配置后,必须通过终端命令验证配置结果。重要提醒:在修改环境变量之前就已经打开的命令提示符或 PowerShell 窗口不会重新读取变量,必须新开一个终端窗口进行测试。

按下 Win + R 输入 cmd 回车,打开新的命令提示符窗口,依次执行以下三条测试命令:

1. 验证 Python 解释器与版本号

python --version

如果配置正确,终端应直接打印出对应的版本号,例如:

Python 3.12.3

2. 验证 pip 包管理工具

pip --version

如果 Scripts 目录配置正确,终端会返回 pip 的版本号及其所在的物理路径:

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

3. 查询实际生效的可执行文件路径

where python

该命令会列出系统当前所有能够匹配到的 python.exe 路径,并按照查找优先顺序由上到下排列。正确的输出应该以我们刚才手动添加的真实目录排在最前:

C:\Users\Admin\AppData\Local\Programs\Python\Python312\python.exe

五、常见问题、认知混淆与避坑排查

即便完全按照上述步骤操作,部分用户仍会遇到诸如“输入 python 自动跳转微软商店”、“版本显示不符合预期”等典型问题。以下是三个最常见的混淆与对应解决方案。

Windows 10/11怎么添加Python环境变量
图 3:应用别名拦截原理与 Path 条目上下移动优先级示意

1. 为什么在终端输入 python 弹出微软商店(Microsoft Store)?

这是 Windows 10 与 11 最普遍出现的问题。微软在系统中预置了名为“应用执行别名”的功能,并在系统默认路径中放入了指向微软商店的 python.exe 占位快捷方式。如果你的真实 Python 路径没有配置好,或者在环境变量列表中排在了微软默认路径的下方,系统就会命中该占位符并唤起商店。

解决方式极其简单:打开 Windows“设置” -> “应用” -> “高级应用设置” -> “应用执行别名”(Windows 10 位于“应用和功能”右侧的“应用执行别名”链接),在列表中找到“应用安装程序 python.exe”与“应用安装程序 python3.exe”,将它们全部设置为“关”。关闭后,系统便不会再进行商店重定向。

2. 多版本 Python 并存时的优先级规则

有时候电脑里既装了 Python 3.10 又装了 Python 3.12,但在输入 python --version 时总是显示 3.10。这是因为 Windows Path 变量在查找程序时遵循“自顶向下、首次命中即停止”的机制。只要在列表上方的路径中找到了匹配的可执行文件,就不会继续往下搜索。

若要以新版本为准,只需重新打开环境变量编辑窗口,选中 Python 3.12 及其 Scripts 的那两行,点击右侧的“上移(U)”按钮,将它们挪到旧版本的上方,保存后重新打开终端即可生效。

六、补充:通过官方安装包一键修复或自动添加

如果你觉得手动查找和粘贴路径较为繁琐,或者不慎改乱了路径,还可以使用 Python 官方安装程序进行快速自动修复:

  • 找到下载好的 Python 安装文件(例如 python-3.12.x-amd64.exe)并双击运行;
  • 在弹出的界面中选择“Modify(修改)”,一路点击 Next,在随后的“Advanced Options”界面中勾选“Add Python to environment variables”,然后点击 Install 即可;
  • 如果是初次安装,务必在第一步安装界面的底部勾选“Add python.exe to PATH”,安装程序就会自动完成全部环境变量注册工作。

七、配置速查与总结核验清单

最后,通过以下全景速查卡片梳理本次配置的全部核心要点,供日常使用和排查时快速对比参考。

Windows 10/11怎么添加Python环境变量
图 4:Windows 10/11 Python 环境变量配置全景速查与核验清单
配置项目 路径特征 对应解决的核心能力
Python 主安装目录 ...\Python\Python3xx\ 提供 python.exe,使终端可直接运行 Python 解释器及执行 .py 脚本
Scripts 工具目录 ...\Python\Python3xx\Scripts\ 提供 pip.exe 及第三方库注册的控制台命令(如 pytest、uvicorn 等)
应用执行别名管理 设置 → 应用 → 应用执行别名 关闭系统自带的 python.exe 占位跳转,防止命令被劫持至微软商店
环境变量生效触发 保存后重启 CMD 或 PowerShell 终端进程启动时载入注册表中的最新环境变量列表

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表