Windows上安装 Python 环境并配置环境变量 （超详细教程）

‌一、下载 Python 安装包‌

1. ‌访问官网‌
   打开浏览器，进入 Python 官方下载页面：https://www.python.org/downloads/windows/

2. ‌选择版本‌

   • 推荐选择最新稳定版（如 ‌Python 3.12.x‌），点击 Download Windows installer (64-bit)（64位系统）或 Download Windows installer (32-bit)（32位系统）。
   • 如果不确定系统位数，按 Win + Pause 打开系统信息，查看 ‌系统类型‌。

---

‌二、安装 Python‌

1. ‌运行安装程序‌
   双击下载的 .exe 文件（如 python-3.12.0-amd64.exe），启动安装向导。

2. ‌关键配置选项‌

   • ✅ ‌Add python.exe to PATH‌
     ‌必须勾选此项‌！否则需手动配置环境变量。
   • ‌Customize installation‌（可选）
     如果需自定义安装路径或组件，点击此处（建议默认即可）。

3. ‌选择安装路径（可选）‌

   • 默认路径为 C:\Users\<用户名>\AppData\Local\Programs\Python\Python312。
   • 若需修改路径，点击 Browse 并选择新路径（如 D:\Python312）。

4. ‌安装可选功能‌
   勾选以下选项（默认已勾选）：

   • ✅ Install launcher for all users
   • ✅ Associate files with Python
     点击 ‌Next‌ 继续。

5. ‌完成安装‌
   点击 ‌Install‌ 开始安装，等待进度条完成。

---

‌三、验证 Python 安装‌

1. ‌打开命令提示符‌

   • 按 Win + R，输入 cmd，回车。

2. ‌检查 Python 版本‌
   输入以下命令，若显示版本号则安装成功：

   python --version
   # 示例输出：Python 3.12.0
   

3. ‌检查 pip 工具‌
   输入以下命令验证 pip（Python 包管理工具）：

   pip --version
   # 示例输出：pip 23.3.1 from ... (python 3.12)
   

---

‌四、手动配置环境变量（如果安装时未勾选 PATH）‌

如果安装时未勾选 Add python.exe to PATH，需手动添加环境变量：

1. ‌找到 Python 安装路径‌

   • 默认路径示例：C:\Users\<用户名>\AppData\Local\Programs\Python\Python312
   • 记录以下两个路径：
     • Python 主目录：C:\...\Python312
     • Scripts 目录：C:\...\Python312\Scripts

2. ‌配置环境变量‌

   • 按 Win + S，搜索 环境变量，选择 ‌编辑系统环境变量‌。
   • 点击 ‌环境变量‌ → ‌系统变量‌ 下的 ‌Path‌ → ‌编辑‌。
   • 点击 ‌新建‌，分别添加以下两条路径：

     textCopy Code

     C:\...\Python312 C:\...\Python312\Scripts

   • 点击 ‌确定‌ 保存所有窗口。

3. ‌验证配置‌
   重新打开命令提示符，输入 python --version，确认能识别命令。

---

‌五、升级 pip（可选）‌

在命令提示符中运行以下命令，升级 pip 到最新版本：

bashCopy Code

python -m pip install --upgrade pip

---

‌六、常见问题解决‌

1. ‌python 命令无效‌

   • 检查环境变量是否配置正确（路径是否包含空格或错误）。
   • 重启命令提示符或电脑。

2. ‌权限不足‌

   • 以管理员身份运行命令提示符（右键点击 → 以管理员身份运行）。

3. ‌安装失败‌

   • 关闭杀毒软件或防火墙后重试。
   • 确保下载的安装包与系统位数（32/64位）匹配。

---

完成以上步骤后，你已成功在 Windows 上安装 Python 并配置环境变量，可以开始编写或运行 Python 程序了！