在cursor中可直接构建标准fastapi工程:先创建项目并激活虚拟环境安装依赖,再编写含正确导入的main.py,配置launch.json指定uvicorn模块和main:app入口,最后通过调试面板启动验证接口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用Cursor编写Python接口项目,需绕过其默认的AI优先工作流,直接构建可运行、可调试、可部署的标准FastAPI或Flask工程结构,避免生成代码无法本地启动、依赖缺失、路由不生效等高频失败问题。
初始化项目结构
在Cursor中新建文件夹,右键→Open in Integrated Terminal,执行以下命令创建标准后端目录:
mkdir myapi && cd myapi && python -m venv venv && source venv/bin/activate && pip install fastapi uvicorn python-dotenv
【必须激活虚拟环境后再安装依赖】否则后续所有包都会装进系统Python,导致本地运行报ModuleNotFoundError,且Cursor的AI补全会因路径错乱给出错误导入建议。
编写核心接口文件
在项目根目录新建 main.py,粘贴以下最小可行代码:
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
return {"message": "Hello from Cursor"}
这行代码不能省略from fastapi import FastAPI——Cursor的AI有时会漏掉导入,直接写app = FastAPI()会导致运行时报NameError。
配置运行参数
点击Cursor左下角Run and Debug图标 → 点击create a launch.json file → 选择Python → 替换生成的launch.json内容为:
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch API",
"type": "python",
"request": "launch",
"module": "uvicorn",
"args": [
"main:app",
"--host", "127.0.0.1",
"--port", "8000",
"--reload"
],
"console": "integratedTerminal",
"justMyCode": true
}
]
}
注意"module": "uvicorn"和"args"中"main:app"必须严格匹配你的文件名和变量名,大小写错误将导致ImportError: No module named 'main'。
启动并验证接口
按Ctrl+Shift+D打开调试面板 → 选择Launch API → 点击绿色三角形 ▶ 启动。
终端输出出现Uvicorn running on http://127.0.0.1:8000后,在浏览器访问http://127.0.0.1:8000,看到JSON响应{"message":"Hello from Cursor"}即成功。
此时可直接在Cursor中修改main.py里的返回值,保存后--reload会自动刷新,无需手动重启。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











