cursor快速入门学习

176 阅读16分钟

第一课:启航与奠基

🚀 第一步:下载与安装 - 打开新世界的大门

这是你旅程的起点,操作非常简单:

  1. 打开浏览器,访问 Cursor 官网:www.cursor.sh/
  2. 网站会自动检测你的操作系统(Windows、macOS或Linux)。你会看到一个醒目的 Download for ... 按钮。
  3. 点击下载,你会得到一个安装包(如 .dmg、 .exe 或 .AppImage)。
  4. 像安装任何其他软件一样,双击运行安装包,按照提示完成安装。

导师小提示:安装过程没有任何技术门槛,就和安装微信、QQ一样。安装完成后,桌面上会出现Cursor的图标。


🛠️ 第二步:首次设置与个性化 - 调校你的专属助手

首次打开Cursor,你会看到一个简洁的界面,可能全是英文。别担心,我们一步步来。

1. 核心概念:两种AI模式(必懂)

Cursor内置了两种AI引擎,你需要了解它们的区别,这决定了你未来的工作流:

  • Composer(C模式) :这是你最主要的“执行者” 。它专注于根据你的指令,编写或修改当前文件中的代码。你描述需求,它直接生成代码。快捷键是 Ctrl/Cmd + I
  • Chat(Q模式) :这是你的 “技术顾问”和“规划师” 。你可以和它自由对话,提问、解释代码、讨论技术方案、让它帮你分析规划。快捷键是 Ctrl/Cmd + L

你可以把它们想象成:Chat是你的“大脑”,用来思考;Composer是你的“双手”,用来执行。

2. 让它说中文(可选但推荐)

如果你是中文用户,可以先设置界面语言,学习起来更顺畅:

  1. 按下快捷键 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),这会打开一个命令面板
  2. 在命令面板中输入 Configure Display Language 并选择它。
  3. 在弹出的语言列表中,选择 zh-cn(中文简体)
  4. 根据提示重启Cursor,界面就会变成中文了。
3. 新手友好设置:开启“大胆模式”

为了让AI助手在初期更主动、更积极地帮助你,我们可以开启一个实验性功能:

  1. 再次按下 Ctrl/Cmd + Shift + P 打开命令面板。
  2. 输入 Cursor Settings: Open Settings (UI) 并选择。
  3. 在设置界面的搜索框中输入 yolo
  4. 你会看到一个叫 Cursor › Experimental: Yolo Mode 的选项,勾选上它

这个YOLO模式会让Composer(执行者)变得更大胆,在你指令不完整时,它也会尝试推测并给出更完整的代码建议,对于新手学习和快速原型搭建非常有帮助。


✅ 第一课总结与实操任务

好了,第一课的内容就是这些。总结一下,你现在应该:

  1. ✅ 成功安装了Cursor软件。
  2. ✅ 理解了 Chat(顾问)  和 Composer(执行者)  的核心区别。
  3. ✅ (可选)将界面设置为了中文。
  4. ✅ (推荐)开启了YOLO模式,让助手更“敢想敢做”。

📌 你的第一个实操任务:
请打开你安装好的Cursor,尝试完成以下动作:

  1. 按 Ctrl/Cmd + L,看看发生了什么?(应该会打开一个聊天侧边栏)
  2. 按 Ctrl/Cmd + I,看看又发生了什么?(应该会在当前编辑器顶部打开一个输入框)

当你完成这些,并在回复中告诉我你的感受或遇到的任何问题时,我们就将进入激动人心的

第二课:你的第一次AI编码对话 - 从零构建一个网页计算器

我们将通过制作一个  “简易网页计算器”  ,来实战演练Cursor的核心交互方式。请严格按照步骤操作。


第一步:创建项目文件夹与文件

我们要让AI在正确的“画布”上工作。

  1. 新建文件夹:在你的电脑桌面上(或其他你喜欢的位置),新建一个文件夹,命名为 my-calculator

  2. 用Cursor打开文件夹

    • 启动Cursor。
    • 点击左上角菜单 File -> Open Folder(或使用快捷键 Ctrl+O)。
    • 选择你刚刚创建的 my-calculator 文件夹。
  3. 新建HTML文件:在Cursor左侧的文件资源管理器中(一般在左边栏),右键点击 my-calculator 文件夹,选择 New File,输入文件名:index.html

现在,你的“画布”已经准备好了,是一个空白的 index.html 文件。


第二步:初试Chat - 规划与提问

我们先和“技术顾问”(Chat)聊聊,理清思路。

  1. 打开Chat面板:在 index.html 文件已打开的情况下,按下 Ctrl/Cmd + L

  2. 输入你的第一个指令(你可以直接复制):

    我想用HTML、CSS和原生JavaScript创建一个简单的网页计算器。它应该包含0-9数字按钮、加减乘除四个运算符按钮、等号、清零按钮,以及一个显示框。请帮我规划一下需要创建哪些文件,以及大致的代码结构。
    
  3. 查看回复:AI会给出清晰的规划,比如建议创建 index.htmlstyle.cssscript.js 三个文件,并简述每个文件的作用。

导师解说:这一步,你是在扮演产品经理/架构师,让Chat帮你把模糊的想法变成清晰的技术方案。它不直接写代码,但为你铺好了路。


第三步:指挥Composer - 生成核心代码

现在,让“执行者”(Composer)登场,把方案变成现实。

  1. 确保 index.html 文件处于激活状态(光标在文件内)。

  2. 打开Composer:按下 Ctrl/Cmd + I。你会看到编辑器顶部出现一个紫色的输入框。

  3. 输入你的第一个生成指令(请分步操作,不要一次性要求太多):

    • 指令1生成一个包含计算器基本HTML结构的代码,需要一个显示结果的input框,和0-9、加减乘除、等于、清零按钮。
    • 观察:Composer会立刻在 index.html 文件中生成对应的HTML代码。按 Tab 键接受这个建议
    • 指令2:在Composer中继续输入:为这些按钮添加一个简单的CSS网格布局,让它们排列整齐。
    • 观察:Composer可能会在HTML的<style>标签内生成CSS,也可能建议你创建单独的CSS文件。按照它的建议做。
  4. 新建并编写CSS文件

    • 在资源管理器中右键,新建 style.css 文件。
    • 在 style.css 文件中,按 Ctrl/Cmd + I,输入:为计算器创建一个美观的样式,包括按钮样式、显示框样式和整体居中布局。
    • 观察并接受AI生成的CSS代码。
  5. 新建并编写JavaScript文件

    • 同理,新建 script.js 文件。
    • 在 script.js 文件中,按 Ctrl/Cmd + I,输入:为计算器编写完整的交互逻辑,包括数字按钮输入、运算符选择、执行计算、清零功能。注意处理连续运算和错误。

导师解说:这一步,你是指挥官。你把大任务(做计算器)拆解成小指令(做HTML结构、做CSS、做逻辑),然后下达给Composer去执行。小步快跑,即时验证是核心理念。


第四步:运行与调试 - 完成你的作品

代码生成后,必须让它“跑起来”看看。

  1. 在浏览器中打开:在Cursor的资源管理器里,右键点击 index.html 文件,选择 Reveal in File Explorer(或 Show in Finder)找到它,然后双击用浏览器打开。你应该能看到一个计算器界面了!
  2. 测试功能:点点按钮,试试加减乘除,看看是否能正常计算。
  3. 遇到问题,返回Chat求助:如果计算逻辑有问题(比如连续运算出错),回到 script.js 文件,按 Ctrl/Cmd + L 打开Chat,选中出问题的代码段,然后问Chat:“这段计算逻辑好像有问题,当连续按运算符时行为不对,请帮我修复。
  4. 使用Editor指令快速修复:你可以选中一段你觉得冗余或错误的代码,然后按 Ctrl/Cmd + K,输入指令如“简化这段代码”或“添加注释”,让AI进行局部微调。

✅ 第二课总结与核心收获

恭喜你!你已经完成了第一个AI协作编码项目。这一课我们实战演练了:

  1. 完整的工作流规划(Chat) -> 生成(Composer) -> 运行 -> 调试(Chat/Editor)

  2. 三大交互方式的首次使用

    • Chat (Cmd+L) :用于规划与提问
    • Composer (Cmd+I) :用于核心生成与编辑
    • Editor指令 (Cmd+K) :用于局部代码的快速优化
  3. 最重要的心法任务拆解。不要试图一句话让AI生成全部,而要把大项目拆成小步骤,一步步生成、验证、迭代。

📌 你的第二个实操任务:
请按照以上步骤,独立完成这个计算器。在过程中,你一定会遇到各种小问题(比如布局不对、点击没反应)。
这正是学习的关键时刻!  请你把遇到的最具体的一个问题记录下来(例如:“清零按钮按了没反应”或“除法结果没有保留小数”),并告诉我你是如何尝试用Cursor(Chat或Composer)去解决它的。 动手去创造吧,工程师。我等你凯旋。

🧠 第三课:成为高手 - 项目级管理与核心心法

当你管理超过3个文件的项目时,两个核心问题会出现:

  1. AI如何知道我整个项目的结构和代码?
  2. 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“了解全貌”。

  1. 在Chat (Cmd+L) 中输入神奇的指令: @codebase

  2. 然后提问,例如:

    • 请分析这个计算器项目的代码结构,并给出重构建议。
    • 我想添加一个历史记录功能,记录每次计算。请在现有代码基础上,告诉我需要修改哪些地方,并给出关键代码示例。

系统提示:当你使用 @codebase 时,Cursor会创建一个当前项目的语义索引。首次使用可能需要几秒钟,之后AI的回答将基于对你全部代码的理解,它会指出具体在 index.html 的哪里添加DOM元素,在 script.js 的哪里修改变量,在 style.css 的哪里添加样式。


第二部分:核心心法 - 设立项目规则 (Rules)

这是高手的标志性技能。通过创建规则文件,你可以让AI在项目的每一次交互中都记住你的要求,就像为团队制定了一份开发宪法。

如何创建规则文件
  1. 在项目根目录(my-calculator 文件夹)下,新建一个名为  .cursor 的文件夹(注意前面的点)。
  2. 在 .cursor 文件夹内,新建一个名为 rules.mdc 的文件。
  3. 用任何文本编辑器或直接在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生成的代码:

  1. 它是否会尝试创建一个 Calculator 类来封装逻辑?(因为你要求了)
  2. 它生成的函数是否有JSDoc注释?(因为你要求了)
  3. 它是否会使用 const/let 而不是 var?(因为你要求了)

这就是规则的力量——它让AI的输出从“随机应变”变成“高度定制”,大幅减少了返工和风格调整的时间。


✅ 第三课总结与跃迁任务

你现在已经掌握了项目管理者的两把金钥匙:

  1. @ 引用与 @codebase:控制AI的“视野范围”,从单个文件到整个项目。
  2. .cursor/rules.mdc:为AI植入项目的“基因记忆”,统一所有输出。

📌 你的高手跃迁任务:
请在你的 my-calculator 项目中,完整实践本课内容:

  1. 创建 .cursor/rules.mdc 文件,并至少写入3条与你项目相关的规则(可以参考上面的例子)。
  2. 使用  @codebase 指令,让AI为你分析项目,并提出  “添加一个历史记录侧边栏”  的具体实施方案。
  3. 尝试根据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. 文档更新
"根据代码变更更新文档"

最佳实践:

  1. 渐进式使用:从小功能开始,逐步应用到复杂任务
  2. 验证输出:AI生成的代码一定要review和测试
  3. 保持对话:多轮对话通常比单次请求效果更好
  4. 提供上下文:相关的代码、错误信息、需求文档
  5. 设置边界:明确告诉AI什么不要做

这些技巧能显著提升你在Cursor中的开发效率和代码质量。需要针对某个特定场景深入了解吗?