Cursor 完全使用指南

本文是对 Juan Stoppa 的博文《Code Smarter, Not Harder: Developing with Cursor and Claude Sonnet》的改译。之所以称为“改译”,是因为本文大部分内容基于我个人的使用体验进行阐述,但文中的框架参考了他的文章结构。

本篇教程将主要介绍 Cursor 的基本功能和使用方式。

Cursor 简介

Cursor 是由 Anysphere 开发的一款代码编辑器,基于 VSCode 进行定制与优化。因此,您在 VSCode 的配置可无缝迁移至 Cursor,如果您习惯于使用 VSCode 进行开发,迁移过程会非常顺畅。

与 VSCode 最大的不同之处在于,Cursor 内置了 AI 进行代码协作,为此做了诸多改动,提供比在 VSCode 上使用 GitHub Copilot 更优秀的用户体验。我会通过与 GitHub Copilot 的对比来说明这一点。

GitHub Copilot 在 VSCode 中的使用

GitHub Copilot 在 VSCode 中作为一个插件进行集成,主要提供以下功能:

  • 代码补全
  • 类似 GPT 的对话窗口
  • 代码生成与重写

在书写代码时,Copilot 会自动推测后续内容,您只需按下 Tab 键即可接受建议:

Github Copilot 代码补全示例

Copilot 的沉浸式体验确实出色,使得样板代码的复写变得方便,且多数情况下,能够生成所需的代码。

Cursor 的卓越体验

Cursor 的体验远胜于 Copilot,其代码补全的准确性更高,将代码上下文应用于生成上显得尤为出色:

Cursor 对话窗功能示例

Cursor 利用微调模型,能够以 Git 风格的 diff format 精确修改代码段,并可在一次对话中方便传递多个源代码文件的上下文(按下 ctrl + enter)以获得更精准的内容。

除此之外,Cursor 使用的索引功能与 JetBrains 类似,通过向量化的方法优化代码搜索,使生成速度与索引速度流畅:

Cursor 索引功能示例

总体而言,Cursor 的用户体验优于 GitHub Copilot,能够大胆放开受限的功能,从而实现更好的编辑体验。

Cursor 的基本使用

安装

要使用 Cursor,您需前往官网进行下载 Cursor 官网。下载后需注册,支持 Google 与 Github 账号登录。

Cursor 采用订阅制,新用户可享受两周的 Pro 订阅,月费约为 20 美元(140 元上下浮动)。尽管使用起来确实不错,但价格略显昂贵。

首次启动时,Cursor 会提示您是否导入 VSCode 的配置,导入完成后,即可享受 AI 增强版的 VSCode。

快捷键与功能

以下是 Cursor 的一些快捷键及其功能:

1. CTRL/CMD + L — 打开对话框

使用 CTRL/CMD + L 键在编辑器右侧打开对话框:

打开对话框

2. CTRL/CMD + K — 打开生成窗口

使用 CTRL/CMD + K 键在光标上方打开生成窗口:

生成窗口

选中内容后,也可通过该快捷键打开相应窗口,生成内容依据为所选中的文本。

3. CTRL/CMD + I — 打开 Composer

CTRL/CMD + I 可打开 Cursor 的特色功能 —— Composer。使用 Composer,您可以在一个对话窗口中同时对多个文件进行修改。

确保在 Cursor 设置中启用 Composer,按顺序进入设置页面进行开启。

Composer 设置示例

Composer 提供直观的界面,允许您输入复杂的修改步骤,并同时生成相关文件的修改内容。

便捷提供上下文信息

Cursor 提供了多种 @ 注记,能够向大模型注入不同类型的上下文信息。以下是常用的注记:

1. @Files — 传递指定代码文件的上下文

通过输入 @Files 注记,Cursor 会弹出您代码仓库的检索列表,便于您选择需要的文件。

@Files 注记示例

2. @Code — 传递指定代码块的上下文

使用 @Code 注记可以精确传递特定代码片段。相关使用方法类似于 @Files

@Code 注记示例

3. @Docs — 获取函数或库的官方文档上下文

通过 @Docs 注记,您可以从在线文档中获取相关上下文信息。

@Docs 注记示例

4. @Web — 从搜索引擎获取上下文

使用 @Web 注记可自动从搜索引擎抓取相关上下文,但其效果不尽人意。

5. @Folders — 提供文件目录信息的上下文

使用该注记来解决路径问题等。

@Folders 注记示例

总结

如果条件允许,我强烈建议您试试 Cursor,它的用户体验非常出色。虽然本文看似简单,但您一旦亲自体验,定会体会到其带来的极佳开发体验。

👉 野卡 | 一分钟注册,轻松订阅海外线上服务

这篇文章虽然称为改译,但内容几乎完全是我自己的使用体验分享,因此原文与其相较,或许不易对照。

我对此次写作类别有些犹豫,主要是看到原文后才激起了写作的灵感,但其实文章结构受原文影响。有些纠结。

THE END