sublime text 可高效开发 fastapi：需配置 python 虚拟环境并安装 fastapi、uvicorn；推荐 sublimelinter-pycodestyle 和 anaconda 插件；通过自定义构建系统实现 ctrl+b 一键启动；结合终端日志、浏览器文档页与代码编辑三端协同。
Sublime Text 本身不是专为 FastAPI 设计的 IDE，但它轻量、启动快、插件生态灵活，搭配合理配置后，完全可以胜任 FastAPI 的高效开发——尤其适合喜欢简洁界面、注重终端协作和手动控制流程的开发者。
安装与基础环境准备
FastAPI 是基于 Python 3.7+ 的异步框架，依赖 Starlette（异步核心）和 Pydantic（数据校验）。Sublime 不自带 Python 环境管理，需提前配好：
- 用 venv 或 poetry 创建隔离环境，激活后安装：
pip install fastapi uvicorn - 确保系统已安装 curl 或 Postman 类工具，用于快速测试 API
- 推荐安装 Sublime 插件：Package Control → 安装 SublimeLinter-pycodestyle 和 Anaconda（提供基础 lint 与跳转，非完整 IDE 功能）
编写第一个 FastAPI 应用（Sublime 中实操）
新建文件 main.py，粘贴以下最小可运行示例：
from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()
class Item(BaseModel):
name: str
price: float
@app.get("/")
def read_root():
return {"message": "Hello FastAPI"}
@app.post("/items/")
def create_item(item: Item):
return {"item_received": item.name, "price": item.price}
保存后，在终端中运行：uvicorn main:app --reload。服务启动后，自动开放两个地址：
立即学习“Python免费学习笔记（深入）”；
- http://127.0.0.1:8000 —— JSON 接口响应
- http://127.0.0.1:8000/docs —— 自动生成的交互式 Swagger UI 文档
- http://127.0.0.1:8000/redoc —— 更简洁的 ReDoc 文档视图
提升 Sublime 开发体验的关键技巧
FastAPI 高度依赖类型提示，Sublime 原生对 Python 类型推导较弱，但可通过以下方式补足：
- 开启 Sublime 的语法高亮与括号匹配：右下角确认语言为 “Python”，启用
Preferences → Settings中"auto_match_enabled": true - 用 Ctrl+Shift+P 调出命令面板，输入 “Build With…” 选择或新建构建系统，例如保存为
FastAPI.sublime-build：
{
"cmd": ["uvicorn", "main:app", "--reload", "--host", "127.0.0.1", "--port", "8000"],
"working_dir": "$file_path",
"selector": "source.python"
}
之后按 Ctrl+B 即可一键启动服务（需确保当前打开的是 main.py 且环境已激活）。
调试与文档协同建议
Sublime 不支持断点调试，但 FastAPI 的错误反馈非常清晰：
- 启动报错时，Uvicorn 会打印详细 traceback，直接定位到
main.py行号 - 请求返回 422 错误？说明 Pydantic 校验失败 —— 查看响应体中的
detail字段，它会明确告诉你哪个字段类型不对、缺了什么 - 每次保存代码，
--reload自动重启，配合浏览器刷新/docs页面，就能实时看到路径、参数、模型结构更新
基本上就这些。不复杂但容易忽略：保持终端开着看日志 + 浏览器开着看文档 + Sublime 专注写代码，三者并行，就是 Sublime 下 FastAPI 开发最顺手的状态。
