Cursor笔记
目录
- 1. 简介
- 2. 安装和配置
- 3. AI编程
- 1）自动补全
- 2）chat & composer
- 功能组件
- codebase
- Rules for AI
- @提示符
- 4）内嵌对话框
- 4. Git版本控制
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；