本教程仅适用于 Windows系统，包含安装、环境变量、pip 镜像加速、虚拟环境管理等完整配置流程，新手可直接按步骤操作。

一、安装

1. 下载安装包

1. 访问 Python 官网下载页：https://www.python.org/downloads/windows/
2. 选择最新稳定版（推荐 3.12.x 或 3.13.x），下载 Windows Installer (64-bit)
3. 注意：不要下载 "embeddable zip" 版本，那是嵌入式专用

2. 安装步骤

1. 关键第一步：勾选底部 Add Python.exe to PATH（自动配置环境变量，务必勾选）
2. 选择 Customize installation（自定义安装，便于控制路径）
3. Optional Features 页面全选，点击 Next
4. Advanced Options 页面建议勾选：
   • Install for all users
   • Add Python to environment variables
   • Precompile standard library
5. 修改安装路径（建议放在非系统盘根目录），例如 D:\Python312
6. 点击 Install 等待安装完成
7. 安装结束后，点击 Disable path length limit（解除 Windows 260 字符路径限制）

3. 验证安装

按 Win + R 输入 cmd 打开命令提示符，执行：

python --version
pip --version

二、pip 国内镜像源配置（必做，大幅提速）

方法一：一键命令配置（推荐）

打开终端 / 命令提示符，执行：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
pip config set global.timeout 120

方法二：手动创建配置文件

Windows：

• 路径：%APPDATA%\pip\pip.ini
• （通常是 C:\Users\你的用户名\AppData\Roaming\pip\pip.ini）
• 内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120

验证配置

pip config list

输出包含 global.index-url 即配置成功。

常用国内镜像源

镜像源	地址
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple/
豆瓣	https://pypi.doubanio.com/simple/

三、虚拟环境管理（最佳实践）

为什么要用虚拟环境

• 不同项目依赖不同版本的包，互不干扰
• 避免污染全局 Python 环境
• 便于项目迁移和团队协作

venv 官方工具（Python 3.3+ 内置）

创建虚拟环境

# 进入项目目录
cd my_project

# 创建名为 .venv 的虚拟环境（推荐以 .venv 命名）
python -m venv .venv

激活虚拟环境

Windows（cmd）：

.venv\Scripts\activate

Windows（PowerShell）：

.venv\Scripts\Activate.ps1

激活成功后，命令行前缀会出现 (.venv) 标识。

常用操作

# 安装包（激活后直接 pip install）
pip install pandas numpy

# 导出依赖清单
pip freeze > requirements.txt

# 根据清单安装依赖
pip install -r requirements.txt

# 退出虚拟环境
deactivate

四、常见问题排查

1. Windows 提示 "python 不是内部或外部命令"

• 原因：安装时未勾选 Add to PATH
• 解决：手动添加环境变量，将 Python 安装目录及 Scripts 目录加入系统 PATH
• 路径示例：D:\Python312 和 D:\Python312\Scripts

2. pip install 报错 SSL 证书问题

• 解决：在镜像源配置中添加 trusted-host，或使用 --trusted-host 参数

4. 升级 pip 自身

python -m pip install --upgrade pip

五、快速检查清单

安装完成后，依次执行以下命令确认全部正常：

python --version          # 确认 Python 版本
pip --version             # 确认 pip 版本
pip config list           # 确认镜像源配置
python -c "print('Hello')" # 确认运行正常

全部输出正常即表示 Python 环境配置完成。