引言
在安装 Python 时务必勾选 Add Python to PATH。如果已安装但未勾选,可手动设置环境变量。
正确方案(推荐)
为什么容易失败?
- 错误操作:安装时未勾选
Add Python to PATH - 正确操作:安装时必须勾选!
✅ 安装步骤(以 Python 3.11 为例):下载官方安装包 → 勾选
Add Python to PATH→ 点击Install Now→ 安装完成后重启电脑。
手动设置环境变量(已安装未勾选)
步骤 1:找到 Python 安装路径
- 打开文件资源管理器,输入
%LOCALAPPDATA%\Programs\Python。 - 找到 Python 文件夹(如
Python311)。 - 记录两个路径:
- Python 主目录:
C:\Users\你的用户名\AppData\Local\Programs\Python\Python311 - Scripts 目录:
C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts
- Python 主目录:
步骤 2:打开系统环境变量设置
- 右键点击'此电脑' → '属性'。
- 点击'高级系统设置'。
- 在弹出窗口中点击'环境变量'。
步骤 3:添加 Python 到系统 PATH
- 在'系统变量'区域找到
Path→ 点击'编辑'。 - 点击'新建' → 添加上述两个路径。
- 点击'确定'保存。
✅ 关键点:必须包含
Scripts目录,否则pip无法使用。
步骤 4:验证设置
- 重启命令提示符(CMD)。
- 输入以下命令验证:
python --version
pip --version
🚨 常见错误:
- 显示
'python' 不是内部命令:说明环境变量未生效,需重启 CMD。- 显示
pipis not recognized:检查是否添加了Scripts` 路径。
技术解析
| 操作系统 | 环境变量设置 | 说明 |
|---|---|---|
| Windows | 需手动添加 PATH | 早期设计缺陷,但安装时勾选可自动处理 |
| Mac/Linux | 默认 PATH 包含 Python | 通过包管理器安装时自动配置 |
常见问题与解决
- :环境变量修改后建议重启或至少重启 CMD。

