Python 安装与 PATH 环境变量配置完整指南

脚本专家

Python 是脚本编程和自动化中常用的语言。正确安装并配置环境变量是使用 Python 的基础。以下步骤基于 Python 3.12.x 版本，适用于 Windows 系统。

2. python --version
3. pip --version

复制代码

一、下载 Python 安装包

访问 Python 官网（python.org）下载最新的稳定版安装包，例如 Python 3.12.x。选择适合操作系统的安装程序（Windows x86-64 executable installer）。

二、安装时勾选关键选项

启动安装程序后，在安装界面底部务必勾选以下三个选项：

- Add Python to PATH：自动将 Python 解释器和 Scripts 目录写入系统环境变量。
- Install pip：安装包管理工具 pip，用于后续安装第三方库。
- py launcher：支持在同一台机器上管理多个 Python 版本，通过 py 命令调用。

勾选完成后点击“Install Now”进行默认安装。如果需要更改安装路径，可以选择“Customize installation”并手动指定目录。

三、验证安装结果

安装完成后打开命令提示符（CMD）或 PowerShell，按先后顺序执行以下命令：

2. python --version
3. pip --version

复制代码

若安装正常，第一行应返回类似“Python 3.12.x”的版本号，第二行返回“pip 23.x.x”的版本号。

如果出现“'python' 不是内部或外部命令”等报错，说明环境变量未正确配置。此时需手动添加 Python 路径到系统 PATH。

四、手动配置环境变量（当自动配置失败时）

1. 确认 Python 的实际安装路径，例如：
   - C:\Python312\（包含 python.exe）
   - C:\Python312\Scripts\（包含 pip.exe）
2. 打开系统环境变量配置界面：
   - 按 Win + R，输入 sysdm.cpl 并回车。
   - 在“高级”选项卡中点击“环境变量”。
3. 在“系统变量”列表中找到 Path 变量，双击编辑。
4. 点击“新建”，依次添加以下两行：
  

2. C:\Python312\
3. C:\Python312\Scripts\

复制代码

5. 点击“确定”保存，然后关闭所有对话框。
6. 重新启动命令提示符，再次执行

2. python --version

复制代码

和

2. pip --version

复制代码

确认配置生效。

五、常见问题排查

- 如果使用系统自带终端关闭后未生效，尝试打开新的终端窗口。
- 如果之前安装过其他版本的 Python，确保 PATH 中只保留当前需要使用的版本路径，避免冲突。
- 安装时若未勾选“Install pip”，可以在安装后手动执行

2. python -m ensurepip --default-pip

复制代码

来安装 pip。

六、总结

正确配置 Python 环境变量的核心是让命令行能找到 python.exe 和 pip.exe。安装时勾选“Add Python to PATH”是最简洁的方式；若忘记勾选，手动添加系统 PATH 同样可靠。完成配置后，即可通过命令行运行 Python 脚本、安装第三方库（如 requests、numpy），或使用 pip 管理项目依赖。

热心网友1

感谢分享这么详细的指南！我最近刚帮同事配置Python环境，发现很多人容易忽略安装时勾选“Add Python to PATH”这一步，结果后面手动配路径又搞错斜杠方向。你的步骤把常见坑都点到了，特别是手动配置时强调要重启终端，这个细节很关键。另外提个小建议：如果安装多个Python版本，用 `py -3.12` 这种命令也能避免路径冲突，可能对新手更友好。总之很实用的教程，收藏了！

热心网友1

非常感谢楼主这么详细的教程！我按照步骤操作，尤其是那个安装时勾选“Add Python to PATH”的提醒很关键，之前装完老是报错找不到命令，现在终于明白原因了。手动配置那部分也写得很清楚，以后万一遇到问题也不怕了。收藏备用！

热心网友1

写得非常详细，对新手很友好。尤其是强调安装时勾选“Add Python to PATH”和“Install pip”这两点，很多人第一次装容易忘，后面还得手动补，很麻烦。另外手动配置时提醒只保留一个版本的路径，这个细节也很实用，能避免以后莫名其妙的冲突。感谢分享！