💥 新手零门槛！本章手把手带你从零搭建可直接运行、带自动接口文档、规范工程结构的FastAPI后端最小项目。全程无冗余代码，跟着操作一次成功，完美适配新手入门、项目初始化！

FastAPI 是Python主流高性能Web后端框架，对标Java的 SpringBoot、SpringMVC，主打高性能、开发快、自动生成文档、支持异步，是目前AI后端、轻量接口服务的首选框架。

基于上一章搭建完成的项目目录、虚拟环境、依赖配置，本章直接落地核心代码，完成FastAPI应用创建、路由注册、服务启动、路由调试、文档访问全流程。

一、本章学习目标（学完直接上手）

通过本章实战，彻底搞定FastAPI项目初始化，实现以下核心能力：

• ✅ 规范工程结构：区分启动入口与应用创建逻辑，贴合企业级开发规范

• ✅ 实现基础接口：成功访问项目根路径/，返回标准JSON数据

• ✅ 自动接口文档：解锁FastAPI自带 Swagger 在线文档/docs

• ✅ 命令调试能力：可查看应用信息、校验注册路由、排查启动报错

本章核心涉及2个文件（极简结构）：

backend/main.py # 全局启动入口文件 backend/app/factory.py # 应用工厂，统一创建FastAPI实例

二、FastAPI环境依赖安装

2.1 一键安装核心依赖

FastAPI项目运行必须依赖框架本体+异步服务器，官方推荐一键安装标准完整版，无需单独配置服务：

# 安装FastAPI标准完整版（内置uvicorn异步服务器） pip install "fastapi[standard]"

依赖核心作用解析：

• fastapi：核心Web框架，负责接口定义、路由注册、参数校验、文档生成

• uvicorn：ASGI高性能异步服务器，专门用于运行FastAPI项目，支持代码热重载

2.2 FastAPI核心代码原理（新手必看）

先看懂最简Demo，彻底理解FastAPI运行核心逻辑，后续开发一通百通：

from fastapi import FastAPI # 1. 初始化FastAPI应用实例 app = FastAPI() # 2. 注册GET请求根路由 @app.get("/") def read_root(): # 3. 返回JSON格式响应（Python字典自动序列化） return {"message": "Hello FastAPI!"}

逐行代码详解：

• from fastapi import FastAPI：导入框架核心类，用于创建项目实例

• app = FastAPI()：实例化项目，所有路由、配置、中间件都基于该对象

• @app.get("/")：路由装饰器，绑定GET请求方式和根路径地址

• read_root()：路由处理函数，接收前端请求并返回响应数据

三、企业级规范：拆分应用工厂（核心重点）

很多新手写FastAPI会把所有代码写在一个文件里，项目变大后极其混乱！本项目采用工厂模式，将应用创建逻辑单独抽离，符合企业开发规范。

文件路径：backend/app/factory.py

from fastapi import FastAPI def create_app() -> FastAPI: # 1. 创建FastAPI应用实例 app = FastAPI(title="AI后端服务") # 2. 注册根路径接口 @app.get("/") def root(): return {"code": 200, "msg": "FastAPI最小项目启动成功！"} # 3. 返回应用实例 return app

代码核心作用：统一封装应用创建、路由注册逻辑，后续新增配置、中间件、接口都在此扩展，结构清晰易维护。

四、编写项目启动入口文件

入口文件只负责引入并暴露应用实例，保持极简，职责单一。

文件路径：backend/main.py

from app.factory import create_app # 创建并暴露app实例，供uvicorn启动识别 app = create_app()

启动命令对应关系：后续启动命令main:app中，main对应当前文件main.py，app对应文件内暴露的应用实例。

五、项目调试：两步校验代码是否正常

5.1 导入测试（排查路径错误）

进入项目backend目录，执行以下命令，校验项目模块是否可正常导入：

python -c "from main import app; print('✅ 应用导入成功')"

成功效果：输出✅ 应用导入成功

报错排查：提示模块找不到，大概率是未在backend目录执行命令，切换目录重新执行即可。

5.2 路由查看测试（校验接口注册成功）

执行命令查看项目所有已注册路由，验证根接口是否生效：

python -c "from main import app; [print(route.path) for route in app.routes]"

预期输出路由列表：

• /：我们手动编写的根业务接口

• /docs：FastAPI自动生成的Swagger文档地址

• /openapi.json：接口规范描述文件

• /redoc：另一种格式的自动接口文档

出现以上路径，说明项目路由注册完全正常！

六、启动FastAPI后端服务

在backend目录下，执行开发环境启动命令：

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

或者在代码中启动：

if __name__ == '__main__': uvicorn.run( app = "main:app", # main.py文件下的app host = "127.0.0.1", port=8000, reload=True # 热加载，修改代码后，重新加载已经导入的模块，不重启 Python 程序，更新内存中的模块代码。 )

参数详细解析（新手收藏）：

• main:app：指定启动入口文件和应用实例

• --host 0.0.0.0：允许局域网内其他设备访问项目（手机、其他电脑）

• --port 8000：项目启动端口，占用可自行修改为8080、9000等

• --reload：开发必备！开启热重载，修改代码自动重启服务，无需重复启动

看到服务启动日志，说明项目运行成功！

七、浏览器访问测试

7.1 访问根接口

浏览器输入地址：http://127.0.0.1:8000

预期返回JSON数据：

{"code":200,"msg":"FastAPI最小项目启动成功！"}

7.2 打开自动Swagger接口文档

FastAPI最香的功能！零代码自动生成可视化接口文档：

访问地址：http://127.0.0.1:8000/docs

页面可直接查看接口信息、在线调试接口，后续新增的所有接口都会自动更新文档，无需手动编写！

八、本章代码定位与后续迭代规划

本章搭建的是最小可用基础版本，保证项目能正常启动、路由注册、文档生成。后续章节会持续迭代升级：

• 新增配置文件读取、环境变量管理

• 接入DeepSeek大模型，实现AI接口调用

• 新增文件上传、智能对话、接口评估等核心功能

九、本章核心小结

本章完成FastAPI项目从0到1的搭建，掌握核心知识点：

• 掌握FastAPI依赖安装与核心原理，区分框架与服务器作用

• 学会企业级项目拆分：工厂类创建应用、单独入口文件启动

• 熟练使用命令调试项目，排查导入、路由注册问题

• 掌握服务启动、接口访问、自动文档使用方法