~/bGZo/notes

11 min read

Cursor 入门教程 -JetBrains 过度向 - LemonDus

Cursor 使用笔记

前置：之前博主使用的是 JetBrains 的 IDE，VSCode 使用比较少，所以会尽量朝着 JetBrains 的使用习惯及样式去调整。

一、设置语言为中文

如果刚上手 Cursor，那么肯定对 Cursor 中的众多选项配置项不熟悉，这时候如果是默认的英文，会比较妨碍快速熟悉 Cursor，因此可以将其语言调整为中文，因为 Cursor 是以 VSCode 为模版拓展的，所以我们可以直接下载一个中文插件（Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code），安装完重启 Cursor 后就会显示中文界面了。

二、设置 JetBrains 的主题

2.1 颜色主题

Cursor 的默认主题，真的两眼一黑，颜色很淡而且还有大量紫色这样的鲜艳颜色，属于是多看一眼我都会爆炸。后来我在试用了多个主题后，包括最火的吸血鬼主题，还有 Community Material Theme 主题以及所有的 JetBrains 主题，最好用的感觉还是 JetBrains Darcula Theme 这款主题。

设置方法为首选项 → 主题 → 颜色主题，选择 JetBrains Darcula Theme 就可以。

颜色大致如下：

2.2 Icon 主题

Icon 主题选择 JetBrains Icon Theme 这个插件进行安装，在首选项 → 主题 → 文件图标主题中添加图中的 Icon 主题安装：

其图标样式大致如下：

三、插件推荐

除了以上几款主题的插件推荐，还有几款实用的插件也建议安装一下。

Git

首先是两款 Git 相关的插件，分别是 Git Graph 和 Git History，Git Graph 是可以看到分支的提交合并回滚等记录，十分方便，Git History 则是可以查看当前代码是在哪个提交中，提交人是谁，能够更好的追踪溯源。

快捷键

如果用惯了 IDEA 的快捷键，那你肯定不习惯 VSCode 的快捷键，这时候就需要它了：IntelliJ IDEA Keybindings，这款插件安装后可以帮你自动设置好 IDEA 中快捷键，无缝衔接～

Markdown

有一个插件可以直接在 Cursor 中预览 Markdown，名字叫 Markdown Preview Mermaid Support，安装完就可以直接在 Cursor 中预览 MD 文档了。

Go

如果你是一名 Go 语言使用者，那么还可以添加 Go-Zero 的 goctl 插件（goctl）和一个 proto 插件（vscode-proto3），goctl 用于高亮.api 文件，而 vscode-proto3 可用于高亮.proto 文件。

四、Cursor 使用

4.1 界面介绍

Cursor 的界面主要分为四块

  • 最左边就是文件区，可以显示打开的项目文件目录；
  • 中间是展示区，点击文件，文件内容会展示在这里，编写代码就在这个区域；
  • 最右边的就是 Cursor 独有的对话区，可以直接进行对话并帮助你编写代码直接生成到项目中，这也是 Cursor 的核心具体后面会进行介绍；
  • 最后就是下方输出区，日志打印，调试控制台，终端等都在这里。 另外还有一个需要关注的，就是如何展示关闭这三块内容，一开始熟悉 Cursor 的时候我关闭了下方输出窗口，找了半天没有找到，后来发现在界面的右上角：

这三个分别对应着上个界面图里介绍的文件区，输出区和 AI 对话区，点击即可打开或关闭。

4.2 运行与调试

快捷键：最简单的方式也是最快捷的，就是点到对应的文件，直接按 F5 就可以了。

界面交互：

由于 JetBrains 的 IDE 是可以直接在文件中或者调试的，有一个绿色的三角，点击可以选择 run 或者 debug。Cursor 中找了半天没找到，后来发现它在界面的左上角：

点击图标后点击运行和调试即可，要注意选到对应的 main 函数入口文件再进行运行调试，调试的字段参数都在左侧：

debug 工具在上面：

4.3 Git 使用

在界面左上角的 git 标志中，会展示各个项目的源代码管理，点击某个项目的右侧三个小点，可以看到如下展示：

  • 拉取：从该分支的远程分支上拉取最新提交到本地分支上
  • 推送：将本地上该分支的修改内容推送到远程分支上
  • 克隆：通过 ssh 或者 https 链接克隆新的项目
  • 签出到…：切换分支
  • 抓取：从远程上抓取整个项目的变动，包括分支的新增删除 [!NOTE]

注意，如果出现远程与本地 tag 冲突，删除本地 tag 即可。git tag -d 具体 tag 名字

4.4 多项目同时打开

原先在 JetBrains 的 IDE 中，是可以使用 Merge All Project Windows 合并所有的项目，可以方便的在 IDE 顶部进行切换

不过我在 Cursor 中并没有看到有这样的功能，不过有一个类似的，只不过在左侧的文件栏中，具体方法是文件 → 将文件添加到工作区中，这样每个项目都是一个文件夹，可以在文件栏中进行切换，不过感觉还是没有 IDEA 中方便。

4.5 Cursor 特性

4.5.1 智能补全代码

Cursor 可以自动学习你的代码编程习惯，你只要打一点代码，Cursor 就会自动进行智能补全，这时候只需按下 Tab 键，就可以将生成的代码直接补全，这也是 AI 编程中最常用的一种，能够极大提高效率，不过要注意检查生成的代码逻辑是否正确。如图，我只打了 if，就帮忙自动补全了接下来原本要写的代码。

4.5.2 快速添加询问内容

在 Cursor 中，不必再手动复制想要更改的代码片段，或者输出的报错这些内容到对话框中，Cursor 提供了一键添加到快捷功能，选中某个片段，可以看到 Add to Chat 这个功能。

点击后，可以看到这几行以及整个的这个文件的索引都会被添加到对话框中，这样就可以方便的添加上下文，便于模型去理解以达到更好的生成效果，选择好后，输入想要实现或者更改的功能，点击 send 稍等片刻就可以获得生成后的代码了。

4.5.3 内联代码编辑与生成

在选中代码段后，除了 Add to Chat 选项，还有个 Edit 选项，快捷键为系统键➕K，可以快速在代码内生成一个对话框，输入想要实现的内容，会快速在当前内容上进行修改，可以选择 Accept 或者 Reject。

也可以选择 quick question，这就和普通的 AI 对话一样，不会修改代码只提供建议。

4.5.4 Agent 快速生成

Cursor 的协作模式有三种：Ask、Edit 和 Agent 三种模式。

Ask 模式

  • 询问特定代码段的问题

  • 获取复杂函数的解释

  • 查找代码模式和示例

  • 探索并理解代码库 Edit 模式

  • 对代码进行单次编辑

  • 精确应用有针对性的更改

  • 自信地审查和应用更改

  • 单独处理文件 Agent 模式 (默认)

  • 进行代码库范围的更改和重构

  • 根据需求实现新功能

  • 调试跨多个文件的复杂问题

  • 生成测试和文档

  • 保持整个项目的一致性 最常用的是 Agent 模式，其他两种用的比较少。

如果说上面的内联代码快速生成可以提高编程效率，那 Agent 就是一个 AI 配对程序员，可以用于复杂的代码修改，甚至可以大规模进行编辑，比如现在我要生成一个新的时间工具类，我只需使用@指定新文件生成位置，然后告诉其诉求，就可以直接生成一个新的时间类方法文件。

点击 Accept 后，这个新文件可以直接添加到对应目录中，当然如果不满意或者有新的功能需要更改，可以继续在对话框中添加要求直至生成符合自己要求的代码文件。

除了代码，你甚至还可以在 Cursor 中生成流程图之类的文档，给予指令“生成流程图，使用 markdown 语法，并生成一个新文件”，可以得到如图所示的流程图文档：

Agent 的使用方法还有很多很多，这里只是介绍了最基础的用法，更多优质用法需要发掘。

Graph View