目录一、Conda 虚拟环境配置二、安装核心依赖三、编写最简启动代码四、三种项目启动方式五、项目访问与接口文档六、高频报错快速解决一、Conda 虚拟环境配置使用独立虚拟环境隔离项目依赖避免全局环境冲突这里以3.12版本为例终端执行以下命令# 创建虚拟环境 conda create -n fastapi_env python3.12 # 激活虚拟环境 conda activate fastapi_env # 退出虚拟环境备用命令 conda deactivate二、安装核心依赖激活环境后安装 FastAPI 框架和 uvicorn 运行服务器指定稳定版本规避兼容问题# 安装标准版FastAPI pip install fastapi[standard] # 指定版本安装可选稳定推荐 pip install fastapi0.115.12 # 安装运行服务器 pip install uvicorn0.34.2三、编写最简启动代码新建main01.py写入基础项目代码包含根接口和服务启动配置from fastapi import FastAPI import uvicorn app FastAPI() # 基础根接口 app.get(/) def read_root(): return {Hello: World} # 项目启动入口 if __name__ __main__: # 热更新调试模式本地开发专用 uvicorn.run(main01:app, host0.0.0.0, port8000, reloadTrue, debugTrue)核心要点main01:app必须严格对应「文件名:实例变量名」拼写错误会直接启动失败。四、三种项目启动方式三种方式按需选用均支持热更新开发# 方式1直接运行脚本最常用 python main01.py # 方式2终端uvicorn命令启动 uvicorn main01:app --reload # 方式3FastAPI官方调试启动 fastapi dev main01.py五、项目访问与接口文档项目启动成功后可直接访问以下地址FastAPI 自带自动生成接口文档项目根地址http://127.0.0.1:8000交互式调试文档推荐开发使用http://127.0.0.1:8000/docs标准规范文档适合查阅http://127.0.0.1:8000/redoc六、高频报错快速解决针对访问URL报错、页面打不开问题汇总核心解决办法文档/接口无法访问优先检查项目是否真正启动成功、8000端口是否被占用模块不存在报错确认已激活虚拟环境依赖安装完整启动报错核对文件名、main01:app拼写区分大小写
