一、什么是 Cursor？

Cursor 就像一位坐在你电脑里的编程老师。

特点：通过对话理解你的需求，直接帮你写代码/改代码

优势：不需要记住复杂语法，用大白话就能生成专业程序

适合人群：学生/新手/想提高效率的开发者

Cursor 可以直接按照你的需求来，不仅可以对话，最重要的是可以直接修改代码

二、Cursor 安装使用

一）安装指南

访问官网点击下载（https://www.cursor.com/cn)

安装过程可以一直选择下一步

二）注册流程

可以选择谷歌邮箱、GitHub 账号或者点击 sign up 输入自己邮箱，这里以点击 sign up 为例。

输入对应信息：

输入自己的密码：

勾选确认真人：

输入验证码，完成邮箱验证后即可完成注册。

注意：最好使用 163 邮箱，QQ 邮箱有时无法正常显示验证码，163 邮箱可以正常显示。

如果你有 Google 邮箱或者 GitHub 账号最好。

三）登录

打开 cursor，点击右上角小齿轮打开设置

点击 sign in 登录账号即可，创建空白文件夹，打开，选择左侧扩展，下载中文插件，安装成功后，重启。

三、Cursor 免费版与付费版

可以先用免费版的 50 次慢速请求用起来。

四、Cursor 页面初识+快捷键

一）界面初识

区域	作用	快捷键提示
左侧文件树	管理你的项目文件	Ctrl+B 展开/收起
中央编辑区	写代码的核心区域	Ctrl+S 快速保存
右侧AI面板	与AI对话/查看建议	Ctrl+L 唤出对话框
下侧预览区	运行终端	Ctrl+` 打开

二）快捷键

Cmd/Ctrl + K：打开 AI 命令面板，可以用自然语言向 AI 提问或要求它执行特定任务。
Cmd/Ctrl + L：启动全新的 Chat 对话面板，让你能够轻松开始与 AI 的交流。
Cmd/Ctrl + I：打开 Composer，允许你在一个对话窗口中同时对多个文件进行修改。
Cmd/Ctrl + /：通过模型切换选择您喜欢的 AI 模型。
Cmd/Ctrl + Shift + E：AI 修复按钮（fix in chat）。
Cmd/Ctrl + Shift + D：AI 修复按钮（fix in composer）。
基础编辑操作快捷键：

Cmd/Ctrl + S：保存文件。
Cmd/Ctrl + Z：撤销操作。
Cmd/Ctrl + F：搜索功能。
Cmd/Ctrl + H：替换功能。
Cmd/Ctrl + P：快速打开文件。
Cmd/Ctrl + B：跳转到定义。
F12：转到定义。

多光标编辑快捷键：

Cmd/Ctrl + D：选择下一个相同的文本。
Option/Alt + Click：手动添加多个光标。
Option/Alt + Cmd/Ctrl + ↑/↓：在上/下方添加光标。

窗口管理快捷键：

Cmd/Ctrl + \：分割编辑器。

五、Cursor 使用本地文件进行 issues 管理，让代码自动生成

在开发一个产品的时候，会有各种功能任务、bug 修复等说明和跟踪，确保项目顺利进行。一般我们使用 issues 进行管理，善用 issues ，就可以让 Cursor 自己写代码。

感觉使用了这种方式，Cursor 真的变成了一个可靠的外包开发。

一）什么是 Issues

管理 issues 是一门学问，在这里我们只是从最常见的场景进行说明，争取使用最简单的方式进行说明和使用。

1、issues 的类型

最常见的 issues 主要是：

Feature / task，开发过程中需要完成的具体工作单元，如编写某个模块的代码、进行某项测试等
Bug，软件中存在的错误、漏洞或不符合预期功能的地方，会导致软件出现异常行为或产生不正确的结果
一般这两种 issues 就可以解决大部分的开发场景了。

2、常见的 issues 管理方式

有很多的 issues 管理软件，最常见的包括但不限于 Github issues / Trello / Gitlab / Bugzilla 等。

国内的 gitee / coding.net 等项目管理工具也都有 issues 管理。

这些工具都是网页软件服务。一些私有库都需要认证才能访问。也就意味着默认情况下 Cursor 无法读取 issues 的内容。

二）使用本地文件进行 issues 管理

既然在一些情况下 Cursor 读取不到网页中的 issues，我们就可以使用本地文件来进行 issues 管理。

使用本地文件管理有什么好处？

让 Cursor 知道我们要做什么，在做什么。

Cursor 是有能力读取文件的内容的，只要明确的告诉 Cursor 如何识别文件内容，Cursor 就可以把文件内容作为工作上下文，自然就知道我们要做什么了。

Cursor 还可以很方便的读取代码库，不管是 Chat 模式下的 @Codebase 还是在 Composer 下的 agnet 模式（默认读取 @Codebase），都可以阅读整个代码库然后进行工作。

结合代码库和具体的要做的事情的 issue， Cursor 就可以自己把我们要做的事情去编码实现了。

三）如何使用本地 issues

1、本地 /issues 目录

在代码库的根目录创建一个 /issues 目录，/issues 为管理目录。

二级目录是 milestone 是分阶段使用的，命名规则是 m{x}-{name} 表示第几个 milestone，分别是干什么的。

milestone 目录下是具体的 issues 文件，f- 开头的是 feature 新功能，bug-开头的是修 bug。

文件内容结构为：

Title 名称
Introduction 详细说明
Tasks 需要完成的任务
Dependencies 依赖的别的 issue

2、issues 案例 1

# Title实现基础用户管理功能

# Introduction创建基础的用户管理系统,包含用户的基本信息:唯一标识ID、用户名称、头像和手机号。这将作为整个应用的基础用户模型。

- User  
 - id, bigint, 主键, 自增
 - name, varchar(255), 用户名称  
 - avatar_url, varchar(255), 头像URL  
 - mobile, varchar(255), 手机号  
 - energy_coin, bigint, 能量币，默认 0

# Tasks
- [ ] 设计并实现用户数据库架构  
- [ ] 创建用户表,包含字段:id、name、avatar_url、mobile。avatar_url 或者是直接外部链接，或者是 oss 的链接

- [ ] 实现用户CRUD接口 
 - [ ] 创建用户接口(带字段验证) 
 - [ ] 获取用户信息接口  
 - [ ] 更新用户信息接口  
 - [ ] 删除用户接口(软删除)  
 - [ ] 用户列表接口(带分页)

3、issues 案例 2

# Local Issues
// Version: 1.0  
// Author: 大铭 (yinwm@outlook.com)

## 目录结构规范
使用 `/issues` 目录管理代码 issue

### 文件组织规则
- 在 `/issues` 目录下创建问题相关文件
- 首层文件夹以 `milestone` 开头，例如：
  - `m001-InitProject`
  - `m002-UserManagement`
  
### 文件命名规范
- 每个 milestone 下的文件代表一个 issue
- 文件名格式：
  - `{id}-f-` 开头：feature 文件
  - `{id}-bug-` 开头：bug 文件
  - `{id}` 是在 `/issues` 目录下全局唯一的 issue ID

### 文件内容格式
每个 issue 文件应包含以下部分：

#### #Title
issue 的标题

#### #Introduction  
issue 的详细描述

#### #Tasks  
任务列表（使用 Markdown 任务列表语法）：
- `- [ ]` 表示未完成
- `- [x]` 表示已完成  
- `- [-]` 表示正在进行
- `- [*]` 表示已跳过
- `- [!]` 表示已放弃

子任务示例：
```
- [ ] 主任务
  - [ ] 子任务1
  - [ ] 子任务2
  其中 f-babyStage.md 明确指出依赖 f-user.md

4、修改 cursorrules，添加 issues 管理的提示词

使用方式，在 Chat / Composer 中，通过 @ 指定 issue 文件，让 Cursor 知道现在要干什么

明确指定根据哪个 issues 文件进行修改，反过来，再让 cursor 修改 issue 内容

可以看到文件的修改情况，当然了这一步也可以人工进行修改。

四）总结

在之前的文章中我说过和 Cursor 的配合有两种方式，把 Cursor 当做外包或者是和 Cursor 进行结对编程。

通过本地 /issues 的方式，就是更像详细的告诉 Cursor 这个外包人员应该干什么，如何去做。

在 Chat / Composer 中同时 @issue 文件 和 @Codebase 就可以让 Cursor 自己写代码了。