专栏：《3 分钟环境配置》| 阅读时长：约 3 分钟 | 适用系统：Windows 10/11

---

场景：为什么又要配环境？

公司新来了台笔记本，或者重装完系统，第一件事就是装 Python。结果官网下载一堆版本，装完发现 pip 找不到，或者全局包越装越乱，老项目和新项目依赖冲突。这篇文章就一件事：用最短路径，把 Python + 虚拟环境一次性配好，全程可复制粘贴。

---

第一步：下载安装 Python

打开官网直达链接（不需要翻页找）：

https://www.python.org/downloads/windows/

找到页面最上方醒目的 “Download Python 3.x.x” 黄色按钮，点击下载 64-bit 安装包。

运行安装程序时，第一屏只勾一个选项，改一个路径：

1. 勾选 Add python.exe to PATH —— 不勾这个，后面所有命令都会报 "python" 不是内部或外部命令
2. 点击 “Customize installation”
3. 安装路径建议改成 C:\Python313 或者 D:\dev\Python313，别用默认的带空格长路径，有些第三方库编译时会踩坑

后面几屏保持默认，直接点 Next → Install，等进度条走完。

验证安装：

python --version

看到 Python 3.13.x 就是成了。如果提示找不到命令，去系统环境变量 → Path 里检查有没有 C:\Python313 和 C:\Python313\Scripts 这两项，没有就手动加。

---

第二步：换国内镜像源（否则 pip 慢到怀疑人生）

Windows 用户在命令行执行：

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 list

看到 global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple' 就对了。

避坑： 网上很多教程让你新建 pip.ini 文件，新手容易建错位置或者编码不对。直接用 pip config set 命令一步到位，不操心路径问题。

---

第三步：创建虚拟环境（项目隔离，必做）

以后每个项目单独一个虚拟环境，全局环境保持干净。

假设项目目录在 D:\projects\myapp：

# 进入项目目录
cd D:\projects\myapp

# 创建虚拟环境（名字叫 venv，惯用约定）
python -m venv venv

命令执行完，目录下会多出一个 venv 文件夹，里面是一套独立的 Python 解释器和 pip。

激活虚拟环境：

venv\Scripts\activate

激活成功后，命令行前面会出现 (venv) 前缀，像这样：

(venv) D:\projects\myapp>

退出虚拟环境：

deactivate

---

第四步：安装项目依赖

虚拟环境激活状态下，安装包只会装到当前项目里，不会影响全局。

pip install flask requests

装完后导出依赖清单，方便队友或部署环境复现：

pip freeze > requirements.txt

下次重建环境时，一行命令还原：

pip install -r requirements.txt

---

常见问题快速修复

报错	原因	解决
'python' 不是内部或外部命令	安装时没勾选 Add to PATH	重装勾选，或手动加环境变量
'pip' 不是内部或外部命令	Scripts 目录没进 PATH	确认 C:\Python313\Scripts 在环境变量里
venv\Scripts\activate 无响应	PowerShell 执行策略限制	管理员运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
pip 安装超时/断连	没换国内源，或公司网络限制	确认清华源已配，或换阿里/中科大源
虚拟环境激活后 python 还是全局版本	PATH 顺序问题	确保当前项目路径在命令行最前面执行激活

---

核心要点

• 安装 Python 时勾选 Add to PATH，这是 80% 新手翻车点
• pip 必换国内源，官方源在境内基本不可用
• 每个项目独立 venv，依赖冲突和"我电脑上能跑"的问题能少 90%
• requirements.txt 是团队协作文档，养成 freeze 的习惯

配完这四步，你的 Windows Python 开发环境就已经是合格线上水准了。