Guide · 使用教程
Cursor 中文教程:从安装到第一个 AI 协作 feature(2026)
5 分钟用中文带你跑通 Cursor 核心三件套:Tab 自动补全 / Cmd+K 行内编辑 / Cmd+L 项目对话,开箱即用。
Cursor 中文教程:从安装到第一个 AI 协作 feature
如果你听说 Cursor 但还没动手,这篇 5 分钟教程让你跑通核心。本文聚焦"快速上手",深度评测见 Cursor 详细评测。
第 1 步:下载安装
访问 https://cursor.com,点 Download,选你的系统(macOS / Windows / Linux)。
安装包大约 200MB,下载完打开。第一次启动会问"是否导入 VS Code 设置"——选是,所有插件 / 快捷键 / 主题完整继承。
第 2 步:注册账号
启动后 Sign In with Google 或 GitHub。免费版(Hobby)注册即用,无需信用卡。
第 3 步:选模型
右下角 → 设置 → Models。默认是 auto,会智能选 Claude Sonnet / GPT-4o。中文 prompt 推荐用 claude-sonnet,对中文语境理解最准。
第 4 步:第一次 Tab
打开任意 .js / .py / .ts 文件,在文件顶部输入:
// 计算两个日期之间的天数差
function daysBetween
光标停在 Between 后面 1 秒,会出现灰色预测代码,按 Tab 接受。
关键:Cursor 的 Tab 预测多行,不是补全单行。如果它建议太多,按 Esc 拒绝。
第 5 步:第一次 Cmd+K
选中任意一段代码 → 按 Cmd+K(Windows: Ctrl+K)→ 输入"改成 async/await 风格"→ 回车。
AI 会在原位生成修改后的代码 + diff,按 Accept 确认。
中文 prompt 完全可用,例如:
- "提取成单独函数"
- "加上 try/catch 错误处理"
- "改成 TypeScript 严格类型"
- "加上单元测试"
第 6 步:第一次项目对话
按 Cmd+L(Windows: Ctrl+L)打开 Chat。在输入框:
@codebase 这个项目是做什么的?整体架构是什么?
@codebase 让 AI 读整个项目(基于向量索引)。
其他常用 @ 引用:
| 命令 | 作用 |
|---|---|
@文件名 | 引用某个文件 |
@codebase | 全项目检索 |
@docs | 引用第三方库官方文档 |
@web | 让 AI 实时联网 |
@git | 引用最近 commit |
第 7 步:第一次 Composer(多文件改造)
按 Cmd+I 打开 Composer。输入:
在 src/lib/utils.ts 加一个 sleep(ms) 函数;
然后在 src/components/Demo.tsx 中调用它做 1 秒延迟。
Composer 会规划改两个文件,给你完整 diff 预览。每次必看 diff,按 Accept 才生效。
中文 prompt 最佳实践
- 写目标和约束而非过程:「把这段改成函数式风格,纯函数无副作用」比「先把 for 改成 map,再...」更好
- 指明文件:
@xxx.ts 加一个 ...比模糊"加一个 ..."强 10 倍 - 约束输出:「不要新增依赖,只用项目已有的库」防止 AI 引入你没用过的包
学习路径建议
- 第 1 周:只用 Tab + Cmd+K,体验"AI 帮我打字"
- 第 2 周:开始用 Cmd+L @codebase 问项目相关
- 第 3 周:尝试 Composer 做完整 feature
第 3 周末你会知道值不值 $20/月。
下一步
如果跑通了核心三件套,你可能想:
- 看 Cursor 详细评测 了解适合 / 不适合的场景
- 看 Cursor vs Windsurf 决定要不要试试 Windsurf
- 加入 Cursor 中文社区(官方 Discord 中有 #chinese 频道)
常见问题
详见页面底部 FAQ。
常见问题
- Cursor 必须订阅 Pro 才能用吗?
- 不是。免费版(Hobby)有有限 fast requests,足够轻度使用。重度依赖建议 Pro $20/月。
- 中国大陆能注册 Cursor 吗?
- 可以。注册无地区限制,付费需要支持外币的信用卡。
- Cmd+K 和 Cmd+I 有什么区别?
- Cmd+K 是行内编辑(针对选中代码就地修改),Cmd+I 是 Composer(多文件协同改造)。Cmd+K 适合微调,Cmd+I 适合做完整 feature。
- 如何让 Tab 不要太"多嘴"?
- 在设置 → Cursor Tab 中调低 "Cursor Tab Suggestion Threshold",或随时按 Esc 拒绝。
- @codebase 多大的项目能跑得动?
- < 10 万行代码效果最佳。10-50 万行勉强可用但会漏。50 万行以上的 monorepo 建议拆 workspace 再用。