Python 安装路径怎么手动添加进 PATH?
详细讲解如何将 Python 安装路径及 Scripts 目录手动添加进系统 PATH 环境变量。包含路径定位、系统变量配置步骤、多版本优先级处理、命令验证与常见报错排查全流程。
python.exe)以及其附属的 Scripts 目录(存放 pip.exe);接着打开操作系统的“环境变量”编辑窗口,将这两条绝对路径分别新增到 Path 列表中;最后彻底关闭并重新打开命令行终端,执行 python --version 与 pip --version 完成校验。
一、为什么必须同时添加两个路径?
很多初学者在手动配置环境变量时,往往只把 Python 的根目录加到了 PATH 中。结果在终端里运行 python 正常,但在尝试使用 pip install 安装第三方扩展包时,系统却报错提示:'pip' 不是内部或外部命令,也不是可运行的程序或批处理文件。
这是由 Python 在 Windows 平台上的目录结构决定的。当我们在命令行中输入任何指令时,操作系统会按照 PATH 环境变量中登记的文件夹顺序,从上到下逐个查找与该命令匹配的可执行文件:
- Python 主程序根目录(如
C:\Users\用户名\AppData\Local\Programs\Python\Python312或C:\Python312):该目录下包含python.exe和pythonw.exe。将此路径加入 PATH 后,系统才能全局识别python命令。 - Scripts 脚本工具目录(即主目录下的
Scripts文件夹):该目录下独立存放着pip.exe、pip3.exe以及后续通过 pip 安装的各类命令行工具(如pytest.exe、black.exe、wheel.exe等)。将此路径加入 PATH 后,第三方包管理命令才能全局生效。
二、第一步:如何找到本机的 Python 安装路径?
在添加环境变量之前,必须先准确获取 Python 在本机磁盘上的绝对路径。不同安装方式对应的默认路径有所不同,以下是几种直接、可靠的查找方式。
方法 1:若系统内已能通过某种方式打开 Python
如果能通过开始菜单找到 Python 自带的 IDLE,或者在终端中通过 py 启动器启动 Python,可以直接在 Python 交互式环境中执行以下代码打印真实路径:
输出路径中去掉末尾的 \python.exe,剩余部分就是主安装目录:
- 主目录:
C:\Users\Administrator\AppData\Local\Programs\Python\Python312 - Scripts 目录:
C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Scripts
方法 2:检查官方安装包的典型默认路径
如果是从 Python 官网(python.org)下载 exe 安装包安装的,安装路径通常遵循以下两种规律:
| 安装选项 | 主目录默认绝对路径 | Scripts 目录路径 |
|---|---|---|
| 仅当前用户(默认推荐) | C:\Users\<用户名>\AppData\Local\Programs\Python\Python3xx\ |
C:\Users\<用户名>\AppData\Local\Programs\Python\Python3xx\Scripts\ |
| 为所有用户安装(自定义) | C:\Program Files\Python3xx\ 或 C:\Python3xx\ |
C:\Program Files\Python3xx\Scripts\ |
AppData 目录下,在文件资源管理器中默认可能不可见。可以按 Win + R 打开运行窗口,输入 %localappdata%\Programs\Python 并回车,系统会直接打开该文件夹。
三、第二步:Windows 环境变量手动配置完整步骤
找到两条路径后,按照以下标准化流程将其写入系统的 PATH 环境变量中。
-
快捷唤起系统属性窗口:
按下键盘快捷键 Win + R,在弹出的“运行”对话框中输入
sysdm.cpl,然后按回车。系统将直接弹出“系统属性”窗口。 - 进入环境变量配置界面: 在“系统属性”窗口顶部切换到“高级”选项卡,点击右下角的“环境变量(N)...”按钮。
-
在列表中定位 Path 变量:
界面分为上下两块:上半部分是“<当前用户名> 的用户变量”,下半部分是“系统变量”。
- 用户变量中的 Path:配置后只对当前登录的 Windows 用户账号生效。普通权限账号即可修改,推荐个人开发电脑优先在此配置。
- 系统变量中的 Path:配置后对这台电脑上的所有用户账号全局生效,需要管理员权限。
Path(或PATH)的变量,鼠标单击选中它,然后点击下方的“编辑(I)...”按钮(或者直接双击该行)。 -
新建并粘贴两条路径:
在弹出的“编辑环境变量”子窗口中,点击右侧的“新建(N)”按钮:
- 在出现的光标输入框中,粘贴 Python 主安装目录路径,例如:
C:\Users\Administrator\AppData\Local\Programs\Python\Python312\ - 再次点击右侧的“新建(N)”按钮,在另一行中粘贴 Scripts 目录路径,例如:
C:\Users\Administrator\AppData\Local\Programs\Python\Python312\Scripts\
- 在出现的光标输入框中,粘贴 Python 主安装目录路径,例如:
- 逐层点击“确定”保存设置: 修改完成后,必须依次点击当前编辑窗口的“确定”、环境变量主窗口的“确定”,以及系统属性窗口的“确定”。必须连点三次确定,所做更改才会真正写入注册表。
四、第三步:多版本共存与优先级排序
不少开发者的电脑上同时安装了多个版本的 Python(例如旧项目需要 Python 3.9,新项目使用 Python 3.12),或者系统内预装了微软商店的占位链接。此时,PATH 环境变量的上下顺序将直接决定系统优先启动哪一个版本。
1. 自上而下的命中机制
Windows 在 PATH 中检索可执行程序时,采取“首个匹配原则”。也就是说,从列表第 1 行开始自上而下扫描,一旦在某一行所在的目录里找到了同名的可执行文件(如 python.exe),就会立刻调用并终止检索,排在后面的同名程序将被直接忽略。
2. 避开 WindowsApps 劫持
Windows 10 和 11 默认会在用户变量的 PATH 中加入 %USERPROFILE%\AppData\Local\Microsoft\WindowsApps。该目录下存放着微软商店的 0 字节引导程序。如果这一行排在你刚刚添加的 Python 路径之前,每次在命令行输入 python,系统都会拦截并弹窗打开微软应用商店页面,而不是运行你的 Python 解释器。
解决方法:在“编辑环境变量”窗口中,选中刚刚添加的 Python 主目录和 Scripts 目录,连续点击右侧的“上移(U)”按钮,将其移动到 WindowsApps 条目之上,或者直接置顶到列表最上方。
where python。系统会按优先级列出所有命中的路径,排在第一行的就是当前生效的目标。
五、第四步:结果验证与常见问题自查
完成环境变量配置并点击确定后,必须进行实际运行测试以验证环境状态。
1. 规范验证步骤
在新打开的命令提示符(CMD)或 PowerShell 中依次执行以下命令:
2. 常见故障与对应排查清单
| 异常现象 | 根本原因 | 精确修复方法 |
|---|---|---|
输入 python 提示“不是内部或外部命令” |
① 未重启命令行窗口; ② 保存时未点完三次“确定”; ③ 路径拼写错误或包含了多余的英文双引号。 |
关闭当前终端重开;重新打开环境变量界面核对路径是否存在拼写失误;确保路径为纯文本不带双引号。 |
python 可以运行,但 pip 提示“不是内部或外部命令” |
漏添加了 Scripts 目录。 |
重新进入 Path 变量编辑界面,补充添加主目录下的 ...\Scripts\ 路径。 |
输入 python 自动弹窗打开 Windows 应用商店 |
系统自带的 WindowsApps 优先级高于真实 Python 路径。 |
① 在 Path 列表中将 Python 主目录和 Scripts 目录“上移”至 WindowsApps 之前; ② 或在 Windows 设置中搜索“应用执行别名”,关闭 python.exe 的别名开关。 |
| 输出的 Python 版本不是刚刚安装的目标版本 | 电脑上存在多个 Python,旧版本的 Path 排在前面。 | 在 Path 列表中将目标版本的两条路径通过“上移”按钮提升至旧版本条目上方。 |
六、补充:macOS 与 Linux 环境下的手动配置
虽然 macOS 和 Linux 通常依赖包管理器(如 Homebrew、apt)或虚拟环境自动处理路径,但如果选择从源码编译安装或安装到了自定义路径(例如 /usr/local/python3/bin),同样需要手动将二进制目录配置进 PATH。
在 Unix 类系统中,所有的可执行文件(包含 python3 和 pip3)通常都集中存放在同一个 bin 目录下,因此只需要添加一个目录。操作方法如下:
七、总结
手动将 Python 添加进 PATH 环境变量并不复杂,其核心在于把握“双路径结构”与“优先级顺序”:
- 确保同时登记主安装目录与 Scripts 目录,缺一不可;
- 在 Windows 环境变量窗口中,通过“上移”保证目标路径排在 WindowsApps 及其他旧版本之前;
- 保存时连续点击三次确定,并且务必重启命令行终端后再做验证。
完成上述配置后,无论在系统的任何工作文件夹下打开命令行,都能直接调用 Python 解释器、pip 包管理器及其安装的所有扩展工具命令。
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









