Cursor 中文入门教程：打开项目、修改代码、审查与验证

想用 Cursor 修改项目，第一步是选一个可以复现、能够验收的小问题。本文以“文章列表翻到第二页后，搜索条件丢失”为练习，把打开项目、查找原因、修改和检查串成一条完整流程。即使你的项目使用其他语言，也可以沿用这套操作。

更新：2026-09-20。本文依据官方文档整理，未在本机安装实测；提示词和验收案例为教学示例，封面为原创流程示意图。

一、准备项目与可恢复的起点

1. 从 Cursor 官方下载页安装适合系统的版本，启动后完成登录。功能与使用额度以当前账户界面为准。

2. 准备一个自己有权修改的项目副本，打开包含 README、源码和项目配置的根目录，而非仅打开某个代码文件。

3. 先读 README 中的启动与检查命令。记录项目能否正常启动，避免把原有环境故障误认成 AI 修改导致的问题。

4. 若使用 Git，先运行下面的命令，确认已有修改。把自己的未提交工作妥善保存，后续只审查本次任务产生的差异。

git status --short
git diff --stat

官方快速入门提供安装与 Agent 基本操作。Windows 可用 Ctrl+I、Mac 可用 Cmd+I 打开 Agent；快捷键若被自定义，以应用菜单为准。参见 Cursor Quickstart。

二、先让 Agent 找到实际调用链

在 Agent 中提交下面这段提示词，并把方括号换成项目里的真实信息。第一轮只分析，便于判断它有没有找到正确页面。

问题：[文章列表]输入关键词后搜索，翻到第 2 页，结果恢复为全部文章。
期望：翻页后仍按相同关键词筛选。
请先只分析，不修改文件。
找出页面入口、分页事件、请求参数及后端接收位置，给出具体文件和依据。
说明搜索词在哪一步丢失；如果证据不足，指出还需要查看什么。

核对回答中的文件是否真实存在，再对照浏览器里的实际操作。若它只看到按钮，却没查请求参数，就要求继续查到接口；若问题发生在后端筛选，不能只在前端增加一个变量就宣告解决。

三、给一次修改划定边界

确认定位后，再发出实施指令。一个任务只处理一个问题，更容易发现无关改动。

请按刚才确认的原因实施最小修改。
沿用现有分页、状态管理和接口约定，不新增依赖，不改数据库结构。
保留我已有的未提交修改。
覆盖：首次搜索、翻页、修改关键词后重新搜索、清空关键词。
完成后列出修改文件、验证命令和仍未验证的部分；不要把未执行的检查写成通过。

如果 AI 建议重写整个页面，先让它解释为什么现有逻辑无法小步修复。执行安装、迁移或带有数据写入的命令前，读清命令及目标环境；本练习不需要修改线上数据。

四、逐个文件审查，而不是只看完成提示

打开修改差异，重点检查：搜索词是否每次都随分页请求发送；切换关键词时页码是否回到合理起点；总数与列表是否使用相同筛选条件；是否出现无关格式化或依赖更新。也可以在项目目录查看：

git diff --stat
git diff

当前版本还提供 Agent Review，可作为补充审查入口，具体用法见 官方审查文档。自动审查仍需结合真实操作验证。

五、按原始操作验收

1. 运行项目现有的构建或检查命令。例如 .NET 项目在解决方案或项目目录执行 dotnet build；其他项目按 README 操作，不照搬语言不匹配的命令。

2. 搜索一个结果超过一页的关键词，记录第一页结果和总数，再翻到第二页，确认条件仍生效。

3. 换一个关键词重新搜索，检查页码、总数和列表同时更新。

4. 清空关键词，确认恢复正常列表；刷新页面的行为按原产品约定验收，不擅自增加持久化需求。

5. 保留命令结果与操作记录，再决定是否提交代码。构建成功不等于分页行为已经正确。

六、常见问题怎么排查

总在猜文件：确认打开的是完整项目根目录，并提供真实页面名称或接口路径，让它引用读到的代码再判断。

一次改了太多：暂停继续生成，按文件检查差异。仅撤销能确认属于本次 AI 任务的改动，不使用一条强制重置命令清掉整个工作区。

编译过了，页面仍不对：检查当前运行的是否为修改后的服务，核对请求参数与返回数据，沿着最初复现步骤继续查。

修好一个场景又破坏另一个：把失败输入加入同一验收清单；涉及权限或数据写入时，还要验证拒绝路径和未授权请求。

完成标准与延伸阅读

能够说清“原因在哪、改了什么、哪些检查通过、哪些还没做”，才算完成一次可审查的修改。建议先连续做三次小任务，分别记录准备、审查和人工修正时间，再判断是否扩大使用范围。

需要先把口述需求整理成文档，可阅读 Speech To Markdown 语音转文档教程；准备本地模型环境，可先看 本地 AI 模型硬件评估教程。