Cursor 入门:用 AI 编辑器读懂项目并完成第一次修改

适合人群:刚学编程、接手了一个看不懂的项目,或者想试试"用自然语言让 AI 改代码"的同学。需要说明:Cursor 的套餐与计费方式近期变化较大,免费计划的 Agent 请求次数有限;快捷键和菜单名称也可能随版本更新调整。下文步骤以写作时 Cursor 官方文档为准。

最近在 X 上看到一份流传很广的 AI 工具清单,Cursor 被列为"带 AI 助手的代码编辑器"。很多新手装好后只会用聊天框问问题,其实官方推荐的入门路线更稳:先让它讲懂项目,再做一个小改动,最后学会审查改动。下面按这个顺序来。

一、安装并打开一个项目

官方支持的系统:

  • macOS 12 及以上(Apple 芯片和 Intel 都支持);
  • Windows 10 及以上;
  • Linux:推荐用 apt 或 dnf 软件源安装,也提供 AppImage 便携版。

安装后登录账号,选择一个文件夹打开。建议第一次用一个你不怕改坏的练习项目,并且先用 Git 提交一次,方便随时回退。

二、第一步:让 Cursor 讲解代码库

打开 Agent 面板(Mac 上官方给出的快捷键是 Cmd+I,Windows 和 Linux 上一般对应 Ctrl+I),输入:

复制代码
解释一下这个项目:主要入口在哪里、有哪些关键模块,改代码之前我应该先读哪些文件?

Cursor 会自己搜索仓库、读相关文件,然后给出项目结构概览。这是熟悉陌生代码最快的方式之一。

三、第二步:做一个小而安全的修改

不要一上来就让它"重构整个项目"。官方建议先这样问:

复制代码
给出三个小而安全的改进建议,说明各自的利弊,等我选一个再动手。

选一个低风险的,比如改一段提示文案、修一个小的界面问题。如果你已经知道要改什么,直接描述想要的结果即可。

四、第三步:审查改动并验证

Agent 工作时,差异视图会显示它改了哪些行。完成后:

  1. 逐个文件看一遍改动,不理解的地方直接追问"为什么这样改";
  2. 让它运行项目已有的检查,比如测试、类型检查、代码规范检查或本地构建;
  3. 确认没问题再提交。

五、较大的任务用 Plan Mode

当任务涉及多个文件或需求还不清晰时,在 Agent 输入框里按 Shift+Tab 切换到 Plan Mode。此时 Cursor 不会马上写代码,而是:

  1. 先研究代码库找到相关文件;
  2. 向你提几个澄清问题;
  3. 写出详细的实施计划;
  4. 等你批准后再开始动手。

对新手来说,读它写的计划本身就是很好的学习材料。

六、Tab 补全:写代码时的自动建议

Tab 是 Cursor 的 AI 自动补全,会根据你最近的编辑和上下文给出灰色的建议文字:

  • 按 Tab 接受整条建议,按 Esc 或继续输入表示拒绝;
  • 按 Cmd+右方向键(Windows 和 Linux 为 Ctrl+右方向键)逐词接受;
  • 接受后再按一次 Tab,会跳到它预测的下一个修改位置。

想暂停或关闭,点击编辑器右下角的 Tab 状态指示,或到 Cursor Settings 的 Tab 页面设置。

七、用 Rules 让它记住你的习惯

模型本身不会记住上一次对话,Rules 就是每次自动带上的"固定说明":

  • User Rules:在 Customize → Rules 中设置,对所有项目生效,比如"回答请用简体中文,说明简洁";
  • Project Rules :放在项目的 .cursor/rules 目录,文件扩展名必须是 .mdc,可以随代码一起提交;
  • AGENTS.md:放在项目根目录的普通 Markdown 文件,适合简单场景。

在 Agent 里输入 /create-rule 并描述需求,可以让它帮你生成规则文件。官方建议规则保持简短(500 行以内),发现 AI 反复犯同一个错误时再补充。

八、常见问题 FAQ

Q1:免费版够用吗?

写作时免费计划包含有限次数的 Agent 和聊天请求,适合体验和学习。套餐内容近期调整较多,请以官方定价页为准。

Q2:代码会被拿去训练吗?

官方说明可以在设置中开启隐私模式,开启后承诺代码数据不会被用于训练。公司项目请先确认团队规定。

Q3:Rules 对 Tab 补全有效吗?

官方 FAQ 说明 Rules 不影响 Tab 补全,主要作用于 Agent 对话。

九、小贴士

  • 每次让 Agent 动手前先提交一次 Git,改坏了可以直接回退。
  • 一次只交代一件事,并说明"完成后运行测试"。
  • 看不懂的改动一定要追问,把它当作随叫随到的讲解老师。
  • 不要把密钥、密码写进提示词或规则文件。

参考资料

相关推荐
前端双越老师1 小时前
程序员 1v1 访谈系列第五期:裁掉正岗,招外包
agent·ai编程·全栈
咬代码的兽7 小时前
满大街的 AI Agent,怎么判断真假?五个土办法
ai编程·ai agent·agentagent
Tangyuewei13 小时前
小米的 Coding Agent 开源了
人工智能·开源·ai编程
狼爷13 小时前
踩坑实录:OpenCode 端口 49374 占用之谜
aigc·ai编程
文谦南宁AI普工15 小时前
写了个 Agent Card 体检器:一张「自我声明」的名片,能验到什么程度
aigc·agent·ai编程
xn713315 小时前
LiteRT Tensor API C++ 怎么用?XNNPACK、GPU 与 NPU 路线如何选择
ai编程
三轩说15 小时前
停更 5 年,它本该被淘汰 —— 直到 Workbuddy 让它跑在新 M6 上
ai编程