适合人群:刚学编程、接手了一个看不懂的项目,或者想试试“用自然语言让 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 工作时,差异视图会显示它改了哪些行。完成后:
- 逐个文件看一遍改动,不理解的地方直接追问“为什么这样改”;
- 让它运行项目已有的检查,比如测试、类型检查、代码规范检查或本地构建;
- 确认没问题再提交。
五、较大的任务用 Plan Mode
当任务涉及多个文件或需求还不清晰时,在 Agent 输入框里按 Shift+Tab 切换到 Plan Mode。此时 Cursor 不会马上写代码,而是:
- 先研究代码库找到相关文件;
- 向你提几个澄清问题;
- 写出详细的实施计划;
- 等你批准后再开始动手。
对新手来说,读它写的计划本身就是很好的学习材料。
六、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,改坏了可以直接回退。
- 一次只交代一件事,并说明“完成后运行测试”。
- 看不懂的改动一定要追问,把它当作随叫随到的讲解老师。
- 不要把密钥、密码写进提示词或规则文件。
参考资料
- Cursor Docs:Quickstart;Tab completion;Rules
https://cursor.com/docs/get-started/quickstart
转载自 CSDN-专业IT技术社区
原文链接:https://blog.csdn.net/qq_28880087/article/details/168455546



