Cursor笔记

1. 简介

优点：交互式生成和修改代码等文本。

局限：①目前还不能独立完成中大型项目，需要人工分解需求，逐步实现。②幻觉问题，需要人工检查。

2. 安装和配置

1）官网下载安装程序，按提示进行安装。

2）初始配置后，登录。

3）详细配置（三种进入方式：①右上角⚙；②Ctrl+Shift+j；②Ctrl+Shift+p, cursor settings）

①cursor seetings

General
Models
Features
Beta

对于非订阅版用户，免费额度使用完后可以使用自己购买的第三方大模型API。下图示例了如何使用配置deepseek-r1的api。首先仅选中deepseek-r1模型，然后填入自己的API和API域名（示例使用的是阿里云百炼平台），保存后验证。

如果使用其它大模型，注意关闭API key，并勾选要使用的大模型。

②命令面板

通过Ctrl+Shift+p调用命令面板，通过它可以快速执行各种操作。

配置项	说明
configure display language	界面语言，可在扩展中安装中文
open vs code settings	包括多种vsc配置
...	...

（经过一系列配置后），cursor的主界面如下图所示。

cursor主界面组成。
①菜单栏。
②用于控制主侧栏和面板的显示以及设置。
③主侧栏（primary size bar）：资源管理器（explorer），搜索（search），源代码管理（source control），扩展（extentions），运行和调试（run and debug），远程资源管理（remote explorer）等。
④编辑窗口。
⑤面板（panel）：问题（problems），输出（output），调试控制台（debug console），终端（termina），端口（ports），注释（comments）。
⑥AI panel: chat, composer, bug finder.
⑦状态栏：Tab补全设置（Cursor Tab）。
⑧搜索框。
⑨欢迎任务，关闭即可。

3. AI编程

模式	启用方式	功能
chat	`ctrl`+`l` ；选中+`Add to Chat`；Fix；	不能自动生成和修改文件；代码库分析；对话；
composer	`ctrl`+`i`；选中+`Add to Composer`；Fix；	能自动生成和修改文件；能操作多个文件；
自动补全	`tab`	多行编辑；智能改写；光标预测；
内嵌对话	`ctrl`+`k`；选中+`Add to Edit`；	作用域是选中或内嵌对话框下方的区域；

1）自动补全

下图展示了自动补全功能的配置选项，包括多行替换、部分接受（ctrl+右键逐个接受补全内容）、光标预测、注释补全等。

2）chat & composer

功能组件

功能组件	chat	compose
Add context	添加上下文	同左
输入框	支持文本，图片和@	同左
模型列表	设置路径：`Ctrl`+`Shift`+`j` > Models	-
image	图片上传，此外还支持拖拽和粘贴	同左
提交	①submit：直接补全； ②codebase：先读取项目文件，建立索引，然后补全；	①normal：生成或修改文件 ②agent：normal+自动检测和安装组件+代码运行+bug修复
补全内容	①文本行：reply，copy； ②代码片：ask，copy，apply； ③整段文本：copy；	①Restore：恢复之前的代码状态； ②代码片-修改：copy，reapply，reject，accept，show code/diff； ③代码片-接受：copy，reapply，show code/diff； ④整段文本：copy； ⑤Review change：汇总修改；

codebase

cursor的codebase功能用于提前索引代码库，然后将整个项目的代码库作为上下文环境与AI交互。下图展示了codebase功能的配置选项，包括执行索引，是否索引新文件夹，不索引文件列表，是否索引版本历史。

可以通过对话框codebase提交或**@Codebase**在提交时使用codebase作为上下文。

Rules for AI

用于指定每次对话的提示词模板，比如设置角色（编程专家）、输出的语言要求（中文）、代码格式等。

以下是配置界面，其中.cursorrules文件用于设置项目级别的规则，上方文本框用于设置全局规则，前者的优先级高于后者。

@提示符

@提示符用于将不同内容添加到上下文。目前支持的内容如下。

内容	说明	备注
Files	文件	同操作：`Add to Text`；拖拽文件；
Folders	文件夹	同操作：拖拽文件夹到对话框；
Codes	代码片	同操作：选中+`ctrl`+`l`
Docs	文档	互联网文档通过 cursor settings > features > docs 添加
Git	版本历史（本地和远程）
Notepads	notepad文档
Codebase	代码库
Summarized Composers
Cursor Rules
Web	互联网搜索	也可以通过@+url添加特定的互联网页面
Lint errors	检查指定文件的语法错误	chat-only
Definitions	附近区域的定义	内嵌对话框-only

4）内嵌对话框

ctrl+k

Genarate：生成新代码；
- Accept; Reject;
quick question/alt+enter：问答模式；
模型列表
【终端】Submit：生成命令行；
- Run; Reject;

选中+Add to Edit

Submit Edit：代码注释、修改、生成（异常捕获、测试用例）等；
- Accept; Reject;
quick question：同上
模型列表

4. Git版本控制

由于cursor能同时修改多个文件，因此建议引用版本控制，将良好版本提交到云端，以便团队协作。

测试环境：

python：解释器；扩展（解释器指定方式：ctrl+shift+p, python: select interpreter）；
git：git客户端；云端使用gitee；

1）初始化仓库；

2）【远程】新建仓库；

3）【远程】设置访问令牌；

4）将【远程】仓库添加到本地仓库：git remote add origin https://oauth2:个人令牌@仓库url

5）提交版本；

6）同步到【远程】；

7）回滚：git revert commitID；

目录