环境准备：Python、虚拟环境与 pip
本教程共 50 篇 · 第 2 篇 · 更新于 2026-08-12 · 约 7 分钟阅读
本节目标：确认你的 Python 版本够新，并学会用虚拟环境把 FastAPI 所需依赖和其他项目隔离开来。
2-1 为什么先准备环境
写 FastAPI 之前，得先把”工具箱”准备好。就像做饭前要先有干净的灶台和锅。
环境没配对，后面装包可能报错，代码也可能跑不起来。这一章不写接口逻辑，只做三件事：查版本、建隔离、升 pip。
跟着做一遍，你的电脑就有了一个干净、专属于本项目的 Python 工作区。
Tip本章所有命令都在”终端”（Windows 的 PowerShell/CMD，或 macOS、Linux 的终端）里敲。看到
$开头只是表示这是命令行，不需要把$也打进去。
2-2 第一步：确认 Python 版本
FastAPI 0.141.1 要求 Python 至少是 3.10。低于这个版本，有些语法特性用不了。
打开终端，输入下面命令查看版本：
python --version在部分系统上，Python 3 需要用 python3 来调用，那就输入：
python3 --version如果显示类似 Python 3.11.0 或 Python 3.12.5，且主版本号大于等于 3、次版本号大于等于 10，就说明没问题。
Note若显示
Python 3.8.x或更低，请先到 python.org 下载安装 3.10 以上的版本，再回来继续。版本不够会导致后续示例代码无法运行。
确认完版本，记住你用的是 python 还是 python3 这个命令，后面建环境时会用到。
2-3 虚拟环境到底是什么
虚拟环境（virtual environment）可以理解为一个”独立的 Python 小房间”。
正常情况，你用 pip 装的包会进到系统的全局 Python 里。时间一长，A 项目要老版本、B 项目要新版本，就会互相打架。
虚拟环境给每个项目单独准备一份 Python 和一套包目录。在这个房间里装的 FastAPI，不会影响别的房间，也不会被别的项目污染。
Tip一句话：虚拟环境 = 给每个项目一个干净的、互不干扰的 Python 空间。
2-4 为什么一定要用虚拟环境
很多新手图省事，直接往全局 Python 里装包。短期没事，长期会带来三个麻烦。
一是版本冲突。项目甲依赖 FastAPI 0.100，项目乙需要 0.141，全局只能留一个，另一个就跑不了。
二是卸载困难。全局包越堆越多，你不知道哪个还在被用，不敢删，也不敢动。
三是部署出错。本地能跑，上线却报错，常常就是因为本地全局装了某些项目根本没声明的包。
用虚拟环境，这些问题基本都消失。它是 Python 开发的事实标准做法。
Note业界还有更现代的工具
uv，能更快创建环境和装包。新手先用标准venv打基础即可，熟练后再了解uv也不迟。
2-5 创建虚拟环境
进入你想放项目的文件夹，比如新建一个名为 fastapi-demo 的目录并进去：
mkdir fastapi-demo
cd fastapi-demo然后用 Python 自带的 venv 模块创建环境，习惯上把环境目录命名为 venv：
python -m venv venv执行后，当前文件夹里会多出一个 venv 目录，里面装着独立的 Python 解释器和包管理工具。
Tip如果提示找不到
venv，多半是安装 Python 时没勾选”pip”或”venv”相关组件。重新运行 Python 安装包，选”修改”并勾上即可。
2-6 激活虚拟环境
环境建好还不算”进入”。你需要”激活”它，让终端之后的命令都指向这个独立环境。
Windows（CMD 或 PowerShell）：
venv\Scripts\activatemacOS / Linux：
source venv/bin/activate激活成功后，命令行最前面会出现 (venv) 字样，像这样：
(venv) $这表示你已经在虚拟房间里了。此刻再用 pip install 装的包，只进这个房间的抽屉，不影响全局。
Note激活只是对”当前这个终端窗口”生效。你新开一个终端，需要重新 cd 进项目并执行激活命令。
2-7 升级 pip 到最新
虚拟环境刚建好时，自带的 pip 可能不是最新版。装包前先升一下，能少踩很多坑。
在已激活 (venv) 的状态下执行：
python -m pip install --upgrade pip看到 Successfully installed pip-... 就说明升级完成。以后装包统一用 python -m pip 这个写法，比单独敲 pip 更稳妥。
Tip用
python -m pip而非裸pip，能保证装到”当前激活环境”里，避免装错地方。这是官方推荐写法。
2-8 退出虚拟环境
当你做完开发、想回到系统全局 Python，只要一条命令：
deactivate执行后，命令行前面的 (venv) 消失，说明你已离开虚拟房间，回到系统环境。
下次再开发，记得重新 cd 进项目目录并执行激活命令。养成”进项目先激活”的习惯，能省掉大量奇怪报错。
Note
venv目录只属于你这台机器，体积大且可随时重建，所以不要把它提交到 Git。在项目根目录新建.gitignore，写入一行venv/即可让版本控制忽略它。团队协作时，大家各自建自己的虚拟环境，靠依赖清单而不是靠共享目录来对齐版本。
2-9 小结与下一步
到这，你的环境地基已经打好：Python 版本够新、有了一个干净的虚拟环境、pip 也是最新的。
回顾一下关键命令：
python --version # 查版本，需 >= 3.10
python -m venv venv # 建虚拟环境
venv\Scripts\activate # Windows 激活（mac/Linux 用 source venv/bin/activate）
python -m pip install --upgrade pip # 升级 pip
deactivate # 退出环境下一章，我们就在这个环境里正式安装 FastAPI 和用来跑它的 ASGI 服务器 Uvicorn。