Windows 系统下 Python 环境变量设置指南

引言

在安装 Python 时务必勾选 Add Python to PATH。如果已安装但未勾选，可手动设置环境变量。

正确方案（推荐）

为什么容易失败？

• 错误操作：安装时未勾选 Add Python to PATH
• 正确操作：安装时必须勾选！

✅ 安装步骤（以 Python 3.11 为例）：下载官方安装包 → 勾选 Add Python to PATH → 点击 Install Now → 安装完成后重启电脑。

手动设置环境变量（已安装未勾选）

步骤 1：找到 Python 安装路径

1. 打开文件资源管理器，输入 %LOCALAPPDATA%\Programs\Python。
2. 找到 Python 文件夹（如 Python311）。
3. 记录两个路径：
   • Python 主目录：C:\Users\你的用户名\AppData\Local\Programs\Python\Python311
   • Scripts 目录：C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts

步骤 2：打开系统环境变量设置

1. 右键点击'此电脑' → '属性'。
2. 点击'高级系统设置'。
3. 在弹出窗口中点击'环境变量'。

步骤 3：添加 Python 到系统 PATH

1. 在'系统变量'区域找到 Path → 点击'编辑'。
2. 点击'新建' → 添加上述两个路径。
3. 点击'确定'保存。

✅ 关键点：必须包含 Scripts 目录，否则 pip 无法使用。

步骤 4：验证设置

1. 重启命令提示符（CMD）。
2. 输入以下命令验证：

python --version
pip --version

🚨 常见错误：

• 显示 'python' 不是内部命令：说明环境变量未生效，需重启 CMD。
• 显示 pip is not recognized：检查是否添加了 Scripts` 路径。

技术解析

操作系统	环境变量设置	说明
Windows	需手动添加 PATH	早期设计缺陷，但安装时勾选可自动处理
Mac/Linux	默认 PATH 包含 Python	通过包管理器安装时自动配置

常见问题与解决

1. ：环境变量修改后建议重启或至少重启 CMD。