Python Windows 系统安装与开发环境配置文档

一、核心概念先看懂

在开始操作之前，先理解下面几个关键概念，后面就不会迷糊：

二、下载 Python 安装包

1. 打开浏览器，访问 Python 官方网站
2. 页面会自动检测你的系统，显示一个黄色大按钮，例如：
   Download Python 3.12.3
3. 点击按钮，下载 .exe 安装文件（约 25MB）

注意：如果你的电脑是 32 位系统，请往下翻选择 Windows installer (32-bit)。但绝大多数现代电脑都是 64 位，直接点击黄色按钮即可。

三、安装 Python（最关键的一步）

请严格按照以下步骤操作，不要跳过任何细节。

1. 双击运行下载好的安装包
2. 【极其重要】在安装窗口最底部，勾选：
   [√] Add Python 3.12 to PATH
   （如果不勾选，后续所有命令行操作都会报错“找不到 python 命令”）
3. 点击 Install Now（立即安装）
4. 等待进度条走完，出现 Setup was successful，点击 Close 关闭

安装界面注意：

Add Python 3.12 to PATH            ← 一定要打勾！

四、Windows 环境变量配置（手动版）

如果安装时勾选了 PATH，这一步会自动完成。但如果你需要手动检查或配置，请按以下步骤操作：

1. 右键点击“此电脑” → 属性 → 高级系统设置
2. 点击 环境变量
3. 在 系统变量 中找到 Path，双击打开
4. 点击 新建，添加以下两个路径（实际路径以你安装的版本为准）：
   • C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\
   • C:\Users\你的用户名\AppData\Local\Programs\Python\Python312\Scripts\
5. 点击 确定 保存，然后重新打开 cmd 生效

五、验证安装是否成功

1. 按下键盘上的 Win + R，输入 cmd，回车打开命令提示符（黑色窗口）
2. 输入以下命令，然后按回车：

   python --version
   

   如果看到 Python 3.12.3 之类的输出，说明 Python 安装成功。
3. 再验证 pip：

   pip --version
   

   如果看到 pip 24.0 from ...，说明 pip 也正常。

如果遇到报错 'python' 不是内部或外部命令，说明安装时没有勾选 PATH。请卸载 Python（控制面板 → 程序和功能），重新安装并务必勾选 Add Python to PATH。

七、配置虚拟环境（Windows 专用命令）

虚拟环境是 Python 开发中必须掌握的技能，它能让你为每个项目独立管理依赖，避免冲突。

方法一：命令行创建（推荐）

1. 打开 cmd，切换到你要创建项目的目录，例如：

   cd Desktop
   

2. 创建虚拟环境（名为 venv）：

   python -m venv venv
   

3. 激活虚拟环境（Windows 专用命令）：

   venv\Scripts\activate
   

   激活后，命令行前面会出现 (venv) 字样，表示已进入虚拟环境。
4. 在虚拟环境中安装包（例如安装 requests）：

   pip install requests
   

5. 退出虚拟环境：

   deactivate
   

方法二：使用 VS Code 图形化创建（推荐新手）

1. 打开 VS Code，打开你的项目文件夹
2. 按 Ctrl + Shift + P，输入 Python: Create Environment
3. 选择 Venv，然后选择 Python 解释器
4. VS Code 会自动创建并激活虚拟环境

八、配置代码编辑器 / IDE

推荐方案一：VS Code（轻量、免费、适合新手）

1. 下载 VS Code：
2. 安装时建议勾选：
   • 添加到上下文菜单（右键菜单）
   • 将 Code 注册为受支持的文件类型的编辑器
3. 安装 Python 插件：
   • 打开 VS Code，点击左侧 扩展图标（四个方块）
   • 搜索 Python，安装由 Microsoft 发布的那个
4. 配置 Python 解释器：
   • 按 Ctrl + Shift + P，输入 Python: Select Interpreter
   • 选择你安装的 Python 版本（或虚拟环境中的解释器）

九、Windows 中文乱码问题解决

Windows 的 cmd 默认编码是 GBK，而 Python 3 默认使用 UTF-8，有时中文会显示乱码。

解决方法：

1. 在 Python 代码文件开头加上：

   # -*- coding: utf-8 -*-
   

2. 或者在 cmd 中执行以下命令临时切换编码：

   chcp 65001
   

3. 更推荐的方式：使用 VS Code 或 PyCharm 等现代编辑器，它们已经自动处理好编码问题。

十、运行你的第一个 Python 程序

方法一：在交互式命令行中运行

1. 打开 cmd，输入 python 回车，你会看到 >>> 提示符
2. 输入以下代码并回车：

   print("Hello, Windows!")
   print("我的第一个Python程序")
   

3. 屏幕会显示两行文字
4. 输入 exit() 退出

方法二：运行 .py 文件

1. 在桌面上新建一个文本文件，重命名为 hello.py（注意扩展名是 .py）
2. 右键点击，用 VS Code 或 记事本 打开，输入：

   print("Hello from .py file!")
   input("按回车键退出...")   # 防止窗口一闪而过
   

3. 保存文件
4. 在 cmd 中定位到桌面（cd Desktop），然后输入：

   python hello.py
   

5. 你会看到程序输出文字，并等待你按回车

十一、常见 Windows 问题 FAQ

十二、完整配置检查清单

完成以下所有步骤后，你的 Windows 环境才算配置完毕：