想在Cursor中从零开始搭建一个Flask项目，并成功运行首页，整体流程其实可以拆分为五个步骤：先创建项目文件夹，再新建app.py并写好基础路由，接着选择正确的Python解释器，然后运行项目文件，最后在浏览器中访问127.0.0.1:5000进行验证。确认首页可以正常打开后，再借助Cursor快速补齐templates和static目录结构，随后使用AI Assistant生成Flask路由与SQLAlchemy模型，并完成数据库初始化配置。

在Cursor中新建Flask项目并跑通第一个页面

如果你想用Cursor高效开发Flask项目，又不希望被繁琐的初始化步骤拖慢进度，那么从创建项目目录、配置Python环境到写出可正常运行的Hello World页面，整个流程就必须一次走通，尽量避免出现模块找不到、环境不匹配或端口冲突等常见报错。

第一步：打开Cursor → 点击左上角「File」→「New Folder」→ 命名为my_flask_app → 回车确认。

第二步：在新打开的空白工作区中，右键左侧资源管理器空白区域 →「New File」→ 输入app.py → 按回车，然后粘贴以下代码：

from flask import Flask
app = Flask(__name__)

@app.route('/')
def home():
    return 'Hello from Cursor + Flask!'

第三步：按Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux）打开命令面板 → 输入「Python: Select Interpreter」→ 回车 → 选择系统中已安装的Python 3.8+解释器（如果尚未安装，请先安装Python后再继续）→ Cursor底部状态栏会显示当前选中的解释器路径。

第四步：在app.py编辑器中右键 →「Run Python File in Terminal」→ 终端会自动执行python app.py → 如果看到* Running on http://127.0.0.1:5000，且没有红色报错信息，就说明Flask项目已经成功启动。

第五步：打开浏览器，访问http://127.0.0.1:5000 → 如果页面显示Hello from Cursor + Flask!，就表示首页测试通过。这一步如果失败，最常见的问题通常是终端没有激活正确的Python环境，【务必确认终端左上角显示的是你刚刚选择的Python解释器，而不是系统默认的/usr/bin/python】。

用Cursor快速生成templates和static结构

Flask要求模板文件必须放在templates/目录下，静态资源文件必须放在static/目录下，否则调用render_template()时通常会直接报错，提示找不到模板文件。借助Cursor，你可以跳过手动逐层创建目录的重复操作，更快完成Flask项目基础结构搭建。

方法一：在资源管理器空白区域右键 →「New Folder」→ 依次创建两个文件夹：templates和static。

方法二（推荐）：按Cmd+K（Mac）或Ctrl+K（Windows/Linux）调出快捷命令 → 输入「Create Folder Structure」→ 回车 → 在弹出的输入框中粘贴：templates/index.html;static/css/main.css;static/js/app.js → 回车 → Cursor会自动批量创建完整的三级目录与文件路径。

接下来，在templates/index.html中写入基础HTML内容：

Welcome

用Cursor AI Assistant一键补全Flask路由与数据库模型

当你需要快速新增用户登录页、文章列表页，或者继续完善数据库模型时，不必反复翻阅Flask文档——Cursor内置的AI助手可以根据自然语言描述，自动生成更符合Flask开发规范的代码片段，大幅提升开发效率。

第一步：在app.py中，将光标定位到if __name__ == '__main__':上方的空白行。

第二步：按Cmd+L（Mac）或Ctrl+L（Windows/Linux）唤出AI指令框 → 输入：“生成一个/users路由，返回JSON格式的用户列表，包含id和username字段，数据用硬编码模拟” → 回车。

第三步：AI生成代码后，光标停留在新代码末尾 → 按Enter换行 → 再次按Cmd+L → 输入：“生成User模型，含id（主键）、username（字符串，非空）、email（唯一）三个字段，用SQLAlchemy定义” → 回车。

第四步：AI会在下方插入from flask_sqlalchemy import SQLAlchemy以及模型类代码 → 这时需要你手动在app = Flask(__name__)下方补充两行配置：

app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///app.db'
app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False

第五步：在 AI 生成的模型类下方补上一行db = SQLAlchemy(app)，然后保存文件，再到终端执行python -c "from app import db; db.create_all()"。命令执行完成后，会自动生成app.db数据库文件。这个步骤一定不要遗漏，否则后续所有与数据库相关的操作，基本都会直接报出no such table错误。