Cursor笔记

目录 1. 简介2. 安装和配置3. AI编程1）自动补全2）chat & composer功能组件codebaseRules for AI@提示符 4）内嵌对话框 4. Git版本控制

1. 简介

优点：交互式生成和修改代码等文本。 局限：①目前还不能独立完成中大型项目，需要人工分解需求，逐步实现。②幻觉问题，需要人工检查。

2. 安装和配置

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

2）初始配置后，登录。

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

①cursor seetings

GeneralModelsFeaturesBeta

对于非订阅版用户，免费额度使用完后可以使用自己购买的第三方大模型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编程 模式启用方式功能chatctrl+l ；选中+Add to Chat；Fix；不能自动生成和修改文件；代码库分析；对话；composerctrl+i；选中+Add to Composer；Fix；能自动生成和修改文件；能操作多个文件；自动补全tab多行编辑；智能改写；光标预测；内嵌对话ctrl+k；选中+Add to Edit；作用域是选中或内嵌对话框下方的区域； 1）自动补全

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

2）chat & composer 功能组件 功能组件chatcomposeAdd 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+lDocs文档互联网文档通过 cursor settings > features > docs 添加Git版本历史（本地和远程）Notepadsnotepad文档Codebase代码库Summarized ComposersCursor RulesWeb互联网搜索也可以通过@+url添加特定的互联网页面Lint errors检查指定文件的语法错误chat-onlyDefinitions附近区域的定义内嵌对话框-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 oauth2:个人令牌@仓库url 5）提交版本； 6）同步到【远程】； 7）回滚：git revert commitID；