FastAPI 快速上手：从零基础到实操入门

船长@2026-08-12 10:10

1.概述

简介

FastAPI是一个现代、高性能Python Web框架，用于构建API。

网址

文档： https://fastapi.tiangolo.com

源码： https://github.com/tiangolo/fastapi

2.搭建python开发环境

2.1安装Miniconda

下载地址：Directory Listing

选择Miniconda3-latest【windows选择-x86_64.exe】
配置环境变量【示例】：

Path

D:\A_code_ware\Miniconda3

D:\A_code_ware\Miniconda3\Scripts
检测命令

查看是否安装成功：
复制代码
conda info
查看Python版本：
复制代码
python -V

pip配置镜像

1.在资源管理器的地址栏输入%APPDATA%并回车，打开用户的应用数据目录。

2.在该目录下创建pip文件夹（如果不存在的话）。

3.进入pip文件夹，创建pip.ini文件，用文本编辑器打开并添加以下内容（以清华大学镜像源为例）：
复制代码
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn
4.保存文件，之后使用pip安装包时就会从配置的镜像源下载。

2.2安装pycharm

下载地址：PyCharm: The only Python IDE you need

选择：Community版本

2.3创建虚拟环境

创建虚拟环境【Miniconda】

查看所有环境：
复制代码
conda env list
创建虚拟环境：
复制代码
conda create -n fastapi_env python=3.12
激活虚拟环境：
复制代码
conda activate fastapi_env
退出虚拟环境：
复制代码
conda deactivate

创建虚拟环境【pycharm】

1.Settings->Python Interpreter->Add Interpreter->Virtualenv Environment->New environment

2.Location：一般默认在项目目录下的 venv 文件夹，比如：D:\xxx\python_FastAPI_learn\venv

3.Base interpreter：选择你已有的 Python 解释器（比如你现在的D:\A_code_ware\miniconda3\python.exe 也可以，或者系统里其他 Python）

3.编写第一个项目

安装FastAPI及其依赖

复制代码

pip install fastapi==0.115.12
pip install uvicorn==0.34.2

编写代码

python 复制代码

from fastapi import FastAPI
import uvicorn
app = FastAPI()
@app.get("/")
def read_root():
  return {"Hello": "World"}
if __name__ == '__main__':
  uvicorn.run('main:app', host='0.0.0.0', port=8000, reload=True)

访问

http://localhost:8000

swagger界面：http://localhost:8000/docs