第一课:启航与奠基
🚀 第一步:下载与安装 - 打开新世界的大门
这是你旅程的起点,操作非常简单:
- 打开浏览器,访问 Cursor 官网:www.cursor.sh/。
- 网站会自动检测你的操作系统(Windows、macOS或Linux)。你会看到一个醒目的
Download for ...按钮。 - 点击下载,你会得到一个安装包(如
.dmg、.exe或.AppImage)。 - 像安装任何其他软件一样,双击运行安装包,按照提示完成安装。
导师小提示:安装过程没有任何技术门槛,就和安装微信、QQ一样。安装完成后,桌面上会出现Cursor的图标。
🛠️ 第二步:首次设置与个性化 - 调校你的专属助手
首次打开Cursor,你会看到一个简洁的界面,可能全是英文。别担心,我们一步步来。
1. 核心概念:两种AI模式(必懂)
Cursor内置了两种AI引擎,你需要了解它们的区别,这决定了你未来的工作流:
- Composer(C模式) :这是你最主要的“执行者” 。它专注于根据你的指令,编写或修改当前文件中的代码。你描述需求,它直接生成代码。快捷键是
Ctrl/Cmd + I。 - Chat(Q模式) :这是你的 “技术顾问”和“规划师” 。你可以和它自由对话,提问、解释代码、讨论技术方案、让它帮你分析规划。快捷键是
Ctrl/Cmd + L。
你可以把它们想象成:Chat是你的“大脑”,用来思考;Composer是你的“双手”,用来执行。
2. 让它说中文(可选但推荐)
如果你是中文用户,可以先设置界面语言,学习起来更顺畅:
- 按下快捷键
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),这会打开一个命令面板。 - 在命令面板中输入
Configure Display Language并选择它。 - 在弹出的语言列表中,选择
zh-cn(中文简体) 。 - 根据提示重启Cursor,界面就会变成中文了。
3. 新手友好设置:开启“大胆模式”
为了让AI助手在初期更主动、更积极地帮助你,我们可以开启一个实验性功能:
- 再次按下
Ctrl/Cmd + Shift + P打开命令面板。 - 输入
Cursor Settings: Open Settings (UI)并选择。 - 在设置界面的搜索框中输入
yolo。 - 你会看到一个叫
Cursor › Experimental: Yolo Mode的选项,勾选上它。
这个YOLO模式会让Composer(执行者)变得更大胆,在你指令不完整时,它也会尝试推测并给出更完整的代码建议,对于新手学习和快速原型搭建非常有帮助。
✅ 第一课总结与实操任务
好了,第一课的内容就是这些。总结一下,你现在应该:
- ✅ 成功安装了Cursor软件。
- ✅ 理解了 Chat(顾问) 和 Composer(执行者) 的核心区别。
- ✅ (可选)将界面设置为了中文。
- ✅ (推荐)开启了YOLO模式,让助手更“敢想敢做”。
📌 你的第一个实操任务:
请打开你安装好的Cursor,尝试完成以下动作:
- 按
Ctrl/Cmd + L,看看发生了什么?(应该会打开一个聊天侧边栏) - 按
Ctrl/Cmd + I,看看又发生了什么?(应该会在当前编辑器顶部打开一个输入框)
当你完成这些,并在回复中告诉我你的感受或遇到的任何问题时,我们就将进入激动人心的
第二课:你的第一次AI编码对话 - 从零构建一个网页计算器
我们将通过制作一个 “简易网页计算器” ,来实战演练Cursor的核心交互方式。请严格按照步骤操作。
第一步:创建项目文件夹与文件
我们要让AI在正确的“画布”上工作。
-
新建文件夹:在你的电脑桌面上(或其他你喜欢的位置),新建一个文件夹,命名为
my-calculator。 -
用Cursor打开文件夹:
- 启动Cursor。
- 点击左上角菜单
File->Open Folder(或使用快捷键Ctrl+O)。 - 选择你刚刚创建的
my-calculator文件夹。
-
新建HTML文件:在Cursor左侧的文件资源管理器中(一般在左边栏),右键点击
my-calculator文件夹,选择New File,输入文件名:index.html。
现在,你的“画布”已经准备好了,是一个空白的 index.html 文件。
第二步:初试Chat - 规划与提问
我们先和“技术顾问”(Chat)聊聊,理清思路。
-
打开Chat面板:在
index.html文件已打开的情况下,按下Ctrl/Cmd + L。 -
输入你的第一个指令(你可以直接复制):
我想用HTML、CSS和原生JavaScript创建一个简单的网页计算器。它应该包含0-9数字按钮、加减乘除四个运算符按钮、等号、清零按钮,以及一个显示框。请帮我规划一下需要创建哪些文件,以及大致的代码结构。 -
查看回复:AI会给出清晰的规划,比如建议创建
index.html,style.css,script.js三个文件,并简述每个文件的作用。
导师解说:这一步,你是在扮演产品经理/架构师,让Chat帮你把模糊的想法变成清晰的技术方案。它不直接写代码,但为你铺好了路。
第三步:指挥Composer - 生成核心代码
现在,让“执行者”(Composer)登场,把方案变成现实。
-
确保
index.html文件处于激活状态(光标在文件内)。 -
打开Composer:按下
Ctrl/Cmd + I。你会看到编辑器顶部出现一个紫色的输入框。 -
输入你的第一个生成指令(请分步操作,不要一次性要求太多):
- 指令1:
生成一个包含计算器基本HTML结构的代码,需要一个显示结果的input框,和0-9、加减乘除、等于、清零按钮。 - 观察:Composer会立刻在
index.html文件中生成对应的HTML代码。按Tab键接受这个建议。 - 指令2:在Composer中继续输入:
为这些按钮添加一个简单的CSS网格布局,让它们排列整齐。 - 观察:Composer可能会在HTML的
<style>标签内生成CSS,也可能建议你创建单独的CSS文件。按照它的建议做。
- 指令1:
-
新建并编写CSS文件:
- 在资源管理器中右键,新建
style.css文件。 - 在
style.css文件中,按Ctrl/Cmd + I,输入:为计算器创建一个美观的样式,包括按钮样式、显示框样式和整体居中布局。 - 观察并接受AI生成的CSS代码。
- 在资源管理器中右键,新建
-
新建并编写JavaScript文件:
- 同理,新建
script.js文件。 - 在
script.js文件中,按Ctrl/Cmd + I,输入:为计算器编写完整的交互逻辑,包括数字按钮输入、运算符选择、执行计算、清零功能。注意处理连续运算和错误。
- 同理,新建
导师解说:这一步,你是指挥官。你把大任务(做计算器)拆解成小指令(做HTML结构、做CSS、做逻辑),然后下达给Composer去执行。小步快跑,即时验证是核心理念。
第四步:运行与调试 - 完成你的作品
代码生成后,必须让它“跑起来”看看。
- 在浏览器中打开:在Cursor的资源管理器里,右键点击
index.html文件,选择Reveal in File Explorer(或Show in Finder)找到它,然后双击用浏览器打开。你应该能看到一个计算器界面了! - 测试功能:点点按钮,试试加减乘除,看看是否能正常计算。
- 遇到问题,返回Chat求助:如果计算逻辑有问题(比如连续运算出错),回到
script.js文件,按Ctrl/Cmd + L打开Chat,选中出问题的代码段,然后问Chat:“这段计算逻辑好像有问题,当连续按运算符时行为不对,请帮我修复。” - 使用Editor指令快速修复:你可以选中一段你觉得冗余或错误的代码,然后按
Ctrl/Cmd + K,输入指令如“简化这段代码”或“添加注释”,让AI进行局部微调。
✅ 第二课总结与核心收获
恭喜你!你已经完成了第一个AI协作编码项目。这一课我们实战演练了:
-
完整的工作流:
规划(Chat) -> 生成(Composer) -> 运行 -> 调试(Chat/Editor)。 -
三大交互方式的首次使用:
- Chat (
Cmd+L) :用于规划与提问。 - Composer (
Cmd+I) :用于核心生成与编辑。 - Editor指令 (
Cmd+K) :用于局部代码的快速优化。
- Chat (
-
最重要的心法:任务拆解。不要试图一句话让AI生成全部,而要把大项目拆成小步骤,一步步生成、验证、迭代。
📌 你的第二个实操任务:
请按照以上步骤,独立完成这个计算器。在过程中,你一定会遇到各种小问题(比如布局不对、点击没反应)。
这正是学习的关键时刻! 请你把遇到的最具体的一个问题记录下来(例如:“清零按钮按了没反应”或“除法结果没有保留小数”),并告诉我你是如何尝试用Cursor(Chat或Composer)去解决它的。
动手去创造吧,工程师。我等你凯旋。
🧠 第三课:成为高手 - 项目级管理与核心心法
当你管理超过3个文件的项目时,两个核心问题会出现:
- AI如何知道我整个项目的结构和代码?
- AI如何记住我项目的特定规范和要求?
解决这两个问题的能力,将把你和普通用户彻底区分开。
第一部分:核心技能 - 让AI拥有“全局视角”
技能一:精准引用 - 使用 @ 符号
这是你与AI沟通时最重要的技能之一,它能将对话上下文精确锁定在你指定的文件。
-
实战场景:假设你在修改
script.js中的calculate函数,但这个函数依赖于utils.js里的一个工具函数。 -
错误做法:在Chat里直接问:“
为什么我的calculate函数报错了?” AI对你项目一无所知,只能猜测。 -
高手做法:在Chat中输入:
@utils.js 请先理解这个工具文件。然后,我们再分析 @script.js 中第30行附近的calculate函数为什么报错。 -
效果:AI会先读取
utils.js的全部内容作为上下文,再结合script.js的代码进行分析,给出的答案将精准十倍。 -
你也可以引用文件夹:
@src/components/会让AI了解该目录下所有文件。
立即练习:在你的计算器项目里,打开Chat (Cmd+L),输入 @style.css,然后问:“如何将这里的按钮颜色主题改为深色模式?” 观察AI的回答是如何基于你实际CSS文件内容给出的。
技能二:终极武器 - 索引整个代码库 (@codebase)
当你需要对项目进行全局分析、重构或添加大型功能时,你需要让AI“了解全貌”。
-
在Chat (
Cmd+L) 中输入神奇的指令:@codebase -
然后提问,例如:
- “
请分析这个计算器项目的代码结构,并给出重构建议。” - “
我想添加一个历史记录功能,记录每次计算。请在现有代码基础上,告诉我需要修改哪些地方,并给出关键代码示例。”
- “
系统提示:当你使用 @codebase 时,Cursor会创建一个当前项目的语义索引。首次使用可能需要几秒钟,之后AI的回答将基于对你全部代码的理解,它会指出具体在 index.html 的哪里添加DOM元素,在 script.js 的哪里修改变量,在 style.css 的哪里添加样式。
第二部分:核心心法 - 设立项目规则 (Rules)
这是高手的标志性技能。通过创建规则文件,你可以让AI在项目的每一次交互中都记住你的要求,就像为团队制定了一份开发宪法。
如何创建规则文件
- 在项目根目录(
my-calculator文件夹)下,新建一个名为.cursor的文件夹(注意前面的点)。 - 在
.cursor文件夹内,新建一个名为rules.mdc的文件。 - 用任何文本编辑器或直接在Cursor里打开它。
规则文件写什么?
在 rules.mdc 中,用纯文本(Markdown格式)写下你对本项目的一切要求。例如:
# 项目专用规则
## 技术栈与规范
- 本项目使用原生JavaScript,禁止引入第三方库。
- 所有CSS类名使用BEM命名约定(如 `.calculator__display`)。
- 使用现代ES6+语法(const/let, 箭头函数)。
## 代码风格
- 使用2个空格缩进。
- 每个函数必须有JSDoc风格的注释。
- 禁止使用`alert`进行用户交互,所有反馈应在UI上显示。
## 计算器特定要求
- 计算器核心逻辑必须封装在`Calculator`类中。
- 要处理除以零的错误,在显示框展示“Error”而不是报错。
- 键盘事件支持:数字键、回车键等于、ESC键清零。
## AI交互指引
- 当被要求修改代码时,优先考虑现有代码结构和风格。
- 在提供代码片段时,同时解释修改的原因和位置。
保存这个文件。
规则生效的奇迹时刻
现在,无论你在项目的哪个文件中与AI交互(Chat或Composer),它都会自动遵守 rules.mdc 中的规定。
测试一下:打开 script.js,用Composer (Cmd+I) 输入:“为当前计算器添加一个百分比按钮功能。”
观察AI生成的代码:
- 它是否会尝试创建一个
Calculator类来封装逻辑?(因为你要求了) - 它生成的函数是否有JSDoc注释?(因为你要求了)
- 它是否会使用
const/let而不是var?(因为你要求了)
这就是规则的力量——它让AI的输出从“随机应变”变成“高度定制”,大幅减少了返工和风格调整的时间。
✅ 第三课总结与跃迁任务
你现在已经掌握了项目管理者的两把金钥匙:
@引用与@codebase:控制AI的“视野范围”,从单个文件到整个项目。.cursor/rules.mdc:为AI植入项目的“基因记忆”,统一所有输出。
📌 你的高手跃迁任务:
请在你的 my-calculator 项目中,完整实践本课内容:
- 创建
.cursor/rules.mdc文件,并至少写入3条与你项目相关的规则(可以参考上面的例子)。 - 使用
@codebase指令,让AI为你分析项目,并提出 “添加一个历史记录侧边栏” 的具体实施方案。 - 尝试根据AI的方案,使用
@引用具体文件 的方式,指挥Composer分步实现这个新功能。
在这个过程中,请务必留意一个现象:在设置了rules.mdc之后,AI生成的代码与之前相比,在风格或思路上有什么明显的不同?
cursor 高阶技巧
1. 智能编辑模式
# 用快捷键快速生成代码
Cmd/Ctrl + K # 打开AI编辑模式
Cmd/Ctrl + L # 让AI分析当前代码
Cmd/Ctrl + Shift + K # 在文件中AI搜索
2. 精准的上下文控制
// 使用@符号引用特定文件
// 在聊天框输入:
@filename.js 请帮我优化这个函数
// 引用多个文件
@utils.js @api.js 请整合这两个模块
// 引用目录
@src/components/ 分析这个目录的结构
3. 代码库级理解
# 创建.cursorrules文件配置项目规则
# 文件内容:
TECH_STACK: React, TypeScript, TailwindCSS
ARCHITECTURE: Feature-based structure
CODING_STANDARDS: Use functional components, no any type
API_PATTERNS: Use React Query for data fetching
TESTING: Jest + React Testing Library
4. 高级提示词技巧
// 1. 多步任务分解
"""
请按以下步骤:
1. 先分析当前组件的props接口
2. 重构为TypeScript
3. 添加错误边界
4. 写单元测试
"""
// 2. 提供示例模板
"""
参考这个格式:
// 示例代码...
请为UserProfile组件创建类似的实现
"""
// 3. 约束生成
"""
生成代码要求:
- 使用React hooks
- 支持Tree-shaking
- 添加JSDoc注释
- 包含错误处理
"""
5. 快捷键组合技
# 快速重构流程
1. 选中代码块 + Cmd/Ctrl + K → "提取为函数"
2. Cmd/Ctrl + Shift + R → 重命名符号
3. Cmd/Ctrl + . → 快速修复建议
# 代码审查
Cmd/Ctrl + Shift + I # 代码审查模式
6. 调试与测试
// 让Cursor帮你调试
"""
这段代码在fetchData时出错:
1. 分析可能的问题
2. 添加调试日志
3. 建议修复方案
"""
// 生成测试用例
"""
为这个hooks生成测试:
- 覆盖所有use cases
- mock API调用
- 测试error状态
"""
7. 项目级操作
# 架构重构
"请分析src/目录,建议更好的模块划分"
# 依赖升级
"检查package.json,安全升级所有依赖"
# 性能优化
"分析组件渲染性能,建议优化点"
8. 自定义工作流
# .cursor/instructions.md 自定义指令
## 代码风格
- 使用async/await而不是Promise.then
- 导出使用named exports
- 组件使用PascalCase
## 项目特定
- API调用必须使用apiClient
- 状态管理使用Zustand
- 表单使用React Hook Form
9. 高级搜索技巧
-- 使用自然语言搜索代码
"找出所有未处理的Promise rejection"
-- 复杂查询
"找到使用过时API的组件并更新"
-- 安全检查
"检查是否有敏感信息硬编码"
10. 集成外部工具
# 结合Git
"基于最近提交生成CHANGELOG"
# 结合CI/CD
"分析测试覆盖率报告,找出薄弱点"
# 结合文档
"根据代码生成API文档"
实用场景示例:
场景1:大型重构
# 1. 先获取概览
"分析整个项目的数据流"
# 2. 制定计划
"将Redux迁移到Zustand的分步计划"
# 3. 批量修改
"找出所有connect()用法并转换"
场景2:性能优化
// 1. 识别问题
"找出重复渲染的组件"
// 2. 应用优化
"为这个列表添加虚拟滚动"
// 3. 验证结果
"优化前后性能对比"
场景3:技术债务
# 1. 代码质量检查
"找出代码中的code smells"
# 2. 自动修复
"修复所有ESLint错误"
# 3. 文档更新
"根据代码变更更新文档"
最佳实践:
- 渐进式使用:从小功能开始,逐步应用到复杂任务
- 验证输出:AI生成的代码一定要review和测试
- 保持对话:多轮对话通常比单次请求效果更好
- 提供上下文:相关的代码、错误信息、需求文档
- 设置边界:明确告诉AI什么不要做
这些技巧能显著提升你在Cursor中的开发效率和代码质量。需要针对某个特定场景深入了解吗?