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 开发最顺手的状态。
