文章已经收录到 GitHub 个人博客项目，欢迎 Star：
https://github.com/chenyl8848/chenyl8848.github.io
或者访问网站，进行在线浏览：
https://chencoding.top/
Cursor 是一款功能强大的 AI 优先代码编辑器，可增强开发工作流程。
主要提供三个核心方向：
关注微信公众号：【Java 陈序员】，获取开源项目分享、AI 副业分享、超 200 本经典计算机电子书籍等。
对比其他编辑工具来说：
1、访问 Cursor 官网并单击下载按钮
https://cursor.com/
2、运行安装程序并等待安装完成
3、通过桌面快捷方式或从应用菜单启动 Cursor
1、点击注册或登录后，系统会提示您设置一个帐户。可以选择使用邮件，或者使用 Google 或 GitHub 账号登录。
如果第一次使用 Cursor，将获得 14 天的免费试用期。
2、登录后，送回 Cursor，然后就可以开始编码了。
新注册的 Cursor 用户有着 14 天免费，50 次免费高级提问的额度，但是也很轻易就会达到上限。
Cursor 会通过检测用户的邮箱账号以及电脑的机器码进行识别，我们出于学习的意图，可以尝试在达到上限后绕过这些限制继续学习。
推荐进行付费使用，功能也会更强大！
可以去 2925 邮箱注册一个账号，这个邮箱平台的一个优势是用户申请的邮箱之后，可以自行创建子邮箱。
比如，创建了 CodeChen@2925.com 这个邮箱，那么我们在 Cursor 申请账号的时候，可以使用 CodeChen123@2925.com、CodeChenabc@2925.com、CodeChen666@2925.com 等邮箱进行注册（也就是 CodeChen数字随意@2925.com），当使用这些子邮箱注册时，会在主邮箱中收到邮件，这样就可以无限制创建和使用邮箱。
2925 邮箱注册地址：
https://www.2925.com/
Cursor 的团队意识到了开发者会通过换邮箱的方式投机取巧，于是加入了校验本机机器码的环节。即使用户注册了一个新的邮箱，但是机器码所属的额度用完之后，也是不能继续免费了。
俗话说，你有张良计，我有过墙梯。有个开源项目 cursor-free-vip 针对 Cursor 的机器码识别问题，提供了重置机器码和快速注册新账号等功能。
1、下载 cusor-free-vip
https://github.com/yeongpin/cursor-free-vip/releases
2、鼠标右键以管理员身份运行 cusor-free-vip
3、输入 1，重置机器 ID
4、输入 2，自动在浏览器中打开 Cursor 注册页面，使用新邮箱重新注册
5、注册成功后，在 Cursor 中登录新账号
在 Cursor 中，具有 Cursor Settings 和 Editor Settings 两个不同的配置入口，分别用于管理 AI 功能 和 编辑器基础设置。
二者的区别如下：
| 对比项 | Cursor Settings | Editor Settings |
|---|---|---|
| 功能定位 | 管理 AI 相关功能和 Cursor 特有设置 | 调整编辑器基础行为和外观 |
| 继承性 | Cursor 独有功能 | 大部分继承自 VS Code（如主题设置） |
| 影响范围 | 影响 AI 代码生成、分析、对话的效果 | 影响代码编辑体验（如排版、颜色） |
| 典型配置示例 | 调整 AI 模型参数、代码库索引路径 | 修改字体、启用自动保存、更改主题 |
| 快捷键 | Ctrl + Shift + J |
Ctrl + Shift + P |
在 Cursor 中可通过页面右上角的设置按钮（齿轮图标）或者使用快捷键 Ctrl + Shift + J 打开 AI 设置。
以下是对 Cursor Settings 中各项配置的作用解释（不同版本的配置可能会不一样，但是都大同小异）：
使用快捷键 Ctrl + Shift + P 打开控制面板，输入 Preferences: Open Settings (UI).
编辑器设置和 VS Code 的设置界面一致。
在 Cursor 编辑器设置中，“User” 和 “Workspace” 存在以下差异：
User（用户）
Workspace（工作空间）
.vscode 文件夹（Cursor 基于 VS Code，沿用类似结构）中，仅在该工作空间打开时生效。Cursor 汉化步骤如下：
Ctrl + Shift + X，左侧边栏会出现扩展商店界面。Ctrl + Shift + P，输入 Configure Display Language 并回车，进入语言配置界面。Cursor 基于 VS Code 设计打造，如之前已经使用过 VS Code, 可将其中的配置迁移至 Cursor 中。
Curson 提供一键导入 VS Code 配置的功能，可以将当前电脑中 VS Code 的 Extensions 扩展、Themes 主题、Settings 设置、Keybindings 键绑定等配置导入到 Cursor 中。
在最新版的 Cursor 一开始安装中，可设置是否导入 VS Code 配置。
VS Code 的配置文件默认位置为：
%appdata%codeuser 路径下的 settings.json 配置文件~/Library/Application Support/Code/User/ 路径下的配置内容~/.config/code/user/ 路径下的配置文件注意：并非所有 VS Code 扩展都与 Cursor 兼容。一些依赖 VS Code 特定 API 的插件，在导入时可能导致整个导入过程失败或部分功能（如主题显示）异常。
如在安装 Cursor 时未设置导入 VS Code 配置，可通过如下方式手动导入：
Ctrl + Shift + J）
如果是在不同电脑的配置，或者希望对设置进行更多控制，可以手动迁移配置文件。
Ctrl + Shift + P）Ctrl + Shift + P）在 Cursor 中进行 Java 开发，需要配置 JDK、Maven 等环境，同时需要安装插件，才能调试、运行 Java 应用程序。
如果在系统环境变量中正确配置了 JAVA_HOME 和 MAVEN_HOME ，且环境变量配置无误（变量值准确指向 JDK 和 Maven 的安装目录 ），部分情况下 Cursor 能自动识别并应用这些配置。
比如，当你在 Cursor 中创建、运行或调试 Java 项目时，它可能会利用自动读取到的环境变量来找到对应的 JDK 和 Maven 位置，完成代码编译、项目构建等操作。
如果 Cursor 没有自动读取到 JDK 和 Maven 配置，就需要手动配置，步骤如下：
1、在 Cursor 输入快捷键 Ctrl + Shift + P 打开命令面板
2、输入 Preferences: Open User Settings (JSON) 并回车，打开 settings.json 文件
3、然后添加或修改以下内容：
{
....
// 配置 JDK
"java.home": "D:/program/jdk1.8",
// 或者使用如下属性配置 JDK
"java.jdt.ls.java.home": "D:/program/jdk1.8",
// 配置 JDK 的多版本，类似于在 IDEA 中的 Project Settings 中选择不同的 Java 运行环境，用于项目启动
"java.configuration.runtimes": [
{
"name": "JavaSE-1.8",
"path": "D:/program/jdk1.8",
"default": true
},
{
"name": "JavaSE-11",
"path": "D:/program/jdk11",
},
{
"name": "JavaSE-17",
"path": "D:/program/jdk17"
},
],
// Maven 环境配置
"java.configuration.maven.userSettings": "D:/program/apache-maven-3.6.3/conf/settings.xml"
}
保存文件后，重启 Cursor 使配置生效。
在 Cursor 中使用 Java 开发，即使已安装 JDK 和 Maven 并配置好环境变量，仍需安装 Java 扩展插件以获得完整的开发体验。这些插件能将编辑器（如 Cursor/VS Code）从普通文本编辑器转变为智能 IDE，提供语法高亮、代码补全、错误提示、调试支持、Maven 项目管理等核心功能。
在 Cursor 中，使用快捷键 Ctrl + Shift + X 打开插件，安装插件 Extension Pack for Java.
这是一个插件集合，而非具体单个插件。它集成了多个与 Java 开发相关的插件，安装后能为开发者在 Visual Studio Code 或 Cursor 等编辑器中提供完整的 Java 开发环境，涵盖从代码编写、调试、测试到项目管理等多方面功能。
注意：选择由 Microsoft 发布的扩展包，并安装。
插件集合中包含如下插件：
提供语法高亮、智能代码补全、代码检查、代码格式化（Shift + Option/Alt + F）、代码导航以及重构支持等功能，辅助高效编写和优化 Java 代码。
实现轻量级 Java 程序调试，可设置断点，调试时查看变量值、对象属性和调用栈，追踪程序执行流程以排查问题。
用于管理 Maven 项目，能创建新项目，管理项目依赖，执行 Maven 构建任务，如清理、编译、打包项目等。
支持 JUnit 和 TestNG 等测试框架，方便运行和调试 Java 测试用例，展示测试结果及详细日志，助力开发者定位问题。
可在编辑器中管理多个 Java 项目，实现快速切换，导入本地 Java 项目，可视化展示项目模块、包和文件结构。
针对 Gradle 构建工具，能创建 Gradle 项目，运行 Gradle 任务，管理项目构建、测试流程，查看 Gradle 任务和工程依赖。
如果习惯于使用 IDEA 进行 Java 应用开发，又想借助 Cursor 的 AI 编程能力，可通过如下两款插件进行二者之间的切换。
顾名思义，这是一款 IDEA 插件，帮助开发者从 IDEA 跳转到 Cursor 编辑器。
环境要求：已安装 Cursor、IDEA 2022.3 及以上版本
安装：在 IDEA 的插件市场搜索 switch2cursor 进行安装
配置 Cursor 路径：在 IDEA 中打开 Settings → Tools → Switch2Cursor 配置 Cursor Path 为你的 Cursor 可执行文件的路径，如：D:softwarecursorCursor.exe 需要替换成自己电脑的 Cursor 安装路径
使用快捷键切换到 Cursor：
Option/Alt + Shift + POption/Alt + Shift + O顾名思义，这是一款 Cursor 插件，帮助开发者从 Cursor 跳转到 IDEA 编辑器。
安装：在 Cursor 扩展市场中搜索 "Switch2IDEA" 并安装
配置 IDEA 路径：打开 Cursor 设置，点击 General → Editor → open editor settings → Extensions → Switch2IDEA → Idea Path
配置 IDEA 安装路径
使用快捷键切换到 IDEA：
Option/Alt + Shift + POption/Alt + Shift + OCursor 的 Tab 键具有强大的代码自动补全功能，基于 AI 模型，能根据代码上下文自动预测并生成代码补全建议和代码修复重构，还可用于代码自动联想等。
使用方式：使用 Tab 键接受建议，Esc 键拒绝建议，Ctrl + → 逐字部分接受建议（部分接受功能需要启用 Partial Accepts 配置项）。
public class ArrayUtil {
// 计算数组平均值
}
Tab 键，Cursor 自动生成代码public class ArrayUtil {
// 计算数组平均值
public static double average(int[] array) {
if (array == null || array.length == 0) {
return 0;
}
int sum = 0;
for (int i = 0; i import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
/**
* 数组工具类
*
* @author
* @version 1.0
* @since 1.0
*/
public class ArrayUtil {
// 计算数组平均值
public static double average(int[] array) {
if (array == null || array.length == 0) {
return 0;
}
int sum = 0;
for (int i = 0; i numbers = Arrays.asList(1, 2, 3, 4, 5);
List evenNumbers = new ArrayList();
for (int num : numbers) {
if (num % 2 == 0) {
evenNumbers.add(num);
}
}
}
}
arrayFor 方法，按 Tab 键，自动补全：// 使用 stream
// 光标放在方法块的任意位置，按 Tab 键
public void arrayFor() {
List numbers = Arrays.asList(1, 2, 3, 4, 5);
List evenNumbers = numbers.stream().filter(num -> num % 2 == 0).collect(Collectors.toList());
}
新建一个 POJO 类，输入几个变量后，Cursor 会自动联想，使用 Tab 键快速生成代码。
public class Person {
// 姓名
private String name;
// 年龄
private int age;
// 性别
private String gender;
// Cursor 会继续联想变量类型，按 Tab 键快速生成
}
Tab 相关配置修改位置：Cursor Settings > Tab.
Ctrl + → 逐个单词接受 AI 建议。比如 AI 建议 const fullName = firstName + " " + lastName;，但你只想用 firstName + 部分，就可通过该快捷键拆分接受。// 实现冒泡排序的步骤：，按 Tab 自动续写步骤说明。比如，如下代码格式不齐整：
public class Demo {
public void test() {
System.out.println("Hello");
if (true) {
System.out.println("World");
}
}
}
public void test() { 这行后面） Tab 会有修改建议public void test() { 这行后面） Tab 不会有修改建议
Chat（之前称Composer）是 Cursor 的 AI 助手，位于编辑器的侧边栏中，通过自然语言与代码库进行交互。
可以提出问题、请求代码编辑、获取终端命令建议等。
Cursor Chat 主要功能：
使用 Ctrl + L 打开侧边栏中的聊天窗口，用中文文字输入请求，Cursor 将做出相应的响应。
注意：与 Chat 对话时，建议采用清晰、具体的语言格式，最好包含任务类型、上下文描述和具体要求。
以下是几个参考模板：
[任务类型]：请生成一个 {功能描述} 的 {编程语言/框架} 实现
[具体要求]：
1. 使用 {特定技术/库}
2. 包含 {特定功能点}
3. 符合 {编码规范/设计模式}
示例：
请生成一个学习计划页面的 HTML + CSS + JavaScript 实现
[具体要求]：
1. 使用Tailwind CSS v3 和 Font Awesome
2. 包含任务添加、编辑、删除功能
3. 包含日历视图展示学习计划
4. 包含学习进度可视化图表
5. 符合现代UI设计原则和响应式设计
6. 具有平滑的动画和交互效果
[任务类型]：请帮我修改 {上下文：具体文件/代码片段}，实现 {预期功能}
[当前问题]：{现有的错误/不足描述}
[具体要求]：
1. 保持 {现有功能/结构} 不变
2. 使用 {特定方法/技术} 改进
3. 修复 {具体错误/警告}
示例：
请帮我修改当前的 React 组件，优化列表渲染性能。
当前问题：滚动时列表卡顿，存在明显性能问题。
要求：
1. 保持现有 UI 不变
2. 使用 React.memo 和虚拟列表技术优化
3. 添加性能监控日志
[任务类型]：请解释 {代码片段/功能模块} 的 {具体方面}
[上下文信息]：{相关业务背景/技术栈}
[具体问题]：
1. {不理解的语法/逻辑}
2. {特定设计选择的原因}
3. {潜在的问题/优化点}
示例：
请解释这段 TypeScript 代码的泛型约束和类型推导逻辑。
上下文：这是一个用于数据验证的工具函数。
具体问题：
1. 这里为什么要加 extends object？
2. 类型推导是如何工作的？
3. 是否存在类型安全隐患？
[任务类型]：请创建一个自动化流程，实现 {目标描述}
[操作步骤]：
1. 从 {数据源} 获取 {数据类型}
2. 执行 {数据处理/转换操作}
3. 将结果保存到 {目标位置}
4. 触发 {后续操作/通知}
[具体要求]：
1. 使用 {特定工具/API}
2. 添加 {错误处理/重试机制}
3. 生成 {日志/报告}
示例：
请创建一个自动化流程，每天凌晨从 GitHub API 获取仓库星标数，保存到 Google Sheets 并生成趋势图。
要求：
1. 使用 GitHub REST API v3
2. 添加异常处理和邮件通知
3. 生成周/月增长趋势图表
[任务类型]：请提供 {操作场景} 的 {操作系统} 命令
[具体需求]：
1. {执行的具体操作}
2. 包含 {特定参数/选项}
3. 处理 {特殊情况/错误}
示例：
请提供在 macOS 上批量压缩图片的命令行方案。
需求：
1. 将当前目录下所有 PNG/JPG 图片压缩 50%
2. 保留原始文件并添加 "-compressed" 后缀
3. 显示每个文件的压缩前后大小对比
提示词技巧总结：
Chat 提供针对特定任务优化的不同模式：
Agent 是 Cursor 中的默认且最自主的模式，旨在以最少的指导处理复杂的编码任务。它启用了所有工具，可以自主探索代码库、阅读文档、联网搜索、编辑文件和运行终端命令以高效完成任务。
Agent 的能力总结：
生成和修改示例：
1、新建一个文件夹，并在 Cursor 中打开
2、使用 Ctrl + L 打开对话模式（默认 Agent 模式）
3、输入用例对话
使用 HTML、Css、Javascript 来实现一个贪吃蛇页面。
要求：
1. 要求有积分统计
2. 页面要有多种背景可以切换
3. 代码添加中文注释
4. 不能使用 var 只能使用 let 和 const 声明变量
4、发送需求，并等待生成代码
5、运行代码对话
将 Html 页面在 Chrome 浏览器打开
6、后续进行对话，进行代码调整或者添加新需求
添加开始游戏按钮，点击后才开始游戏
Agent 的配置选项：
Ctrl + I）错误调试和修改示例：
1、准备错误信息类
public class ArrayDemo {
public static void main(String[] args) {
// 创建一个整数数组
int[] numbers = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
// 使用 for 循环输出数组内容
System.out.println("数组内容如下：");
for (int i = 0; i 2、运行时出现如下报错信息
3、对话解决错误信息：选中错误信息，使用快捷键打开 Chat 模式，输入描述【根据错误信息，解决程序Bug】
Ask 是 Chat 的只读模式，用于提出问题、探索和了解代码库。
Ask 是其他模式（Agent 和 Manual）所独有的，因为它默认不自动应用任何建议的更改，这使它成为一种只读模式，具有读取文件和其他上下文的完整能力，但不能自行进行任何更改。
适合在不想更改代码库或在实施之前使用 AI 规划解决方案的场景下使用。
如在 Ask 模式下给贪吃蛇添加多种游戏模式：
Ask 的配置选项：
@文件 作为上下文与 Ask 模式不同，Manual 模式不探索代码库或运行终端命令。
完全取决于具体说明和提供的上下文（例如，通过 @文件名），AI 生成修改建议后，还需要用户手动点击应用才会改动代码，而且通常是单文件/局部代码调整。
如给代码添加注释：
Manual 的配置选项：
当 Chat 建议更改代码时：
1、Review changes：在差异视图中查看建议的更改
2、Apply: 在Ask/Manual 模式下，使用应用按钮显式应用更改
3、Accept/Reject（接受/拒绝）：进行更改后，决定是保留还是放弃更改
有些情况，需要恢复到代码库的先前状态。Cursor 通过在发出的每个请求以及每次 AI 更改的代码库时自动创建代码库的检查点（Checkpoints）来帮助解决这个问题，类似于 Git 版本管理中的回滚操作。
要恢复到之前的状态，可以：单击上一个请求的输入框中显示的 Restore Checkpoint 按钮。如下所示：
注意：是恢复到本次对话之前的状态，不是本次对话产生的状态。
可以通过 Chat 中的 Show history 图标按钮或者使用快捷键 Ctrl + Alt + '.
开启新任务、避免对话混乱、保留特定记录或解决误操作时，需要在 Cursor 的 Chat 新建会话。
Chat 相关配置修改位置：Cursor Settings > Chat.
.cursorignore 文件规则作用于所有子目录，修改后需要重启 Cursor.内联智能修改（快捷键：Ctrl + K）功能是直接在编辑器窗口中生成新代码或编辑现有代码，适合精准修改代码内容。
在 Cursor 中，将按 Ctrl + K 时出现的弹窗称为 Prompt Bar。它的工作原理类似于在指定代码文件中的 Chat 功能，可以在代码文件中指定区域输入，或使用 @ 引用其他上下文。
内联智能修改的三大功能：
Ctrl + K 时未选择任何代码，Cursor 将根据在提示栏中输入的提示生成新代码。Ctrl + K 后在提示栏中输入需求信息，完成代码重构。Ctrl + K 后在提示栏中输入需求信息，生成脚本命令，然后运行操作。1、创建一个 main.js 文件，光标放文件末尾（无选中代码）
2、按 Ctrl + K，输入提示
生成一个带点击动画的按钮组件，用 JavaScript 实现，点击后控制台打印次数
3、实现效果
1、继续打开刚刚 main.js
2、选中代码块，按 Ctrl + K，输入提示：
添加注释和每行代码添加注释说明
3、实现效果
在 Cursor 中，内联智能修改功能除了能在代码文件中使用，还支持在终端（Terminal）中使用。
在 Cursor 中，可使用快捷键
Ctrl+ 反引号键在编辑器底部打开终端窗口。
把光标定位在终端中，按 Ctrl + K 打开终端底部的提示栏。输入需求，然后生成脚本命令，使用 Ctrl + Enter 接受并运行命令，也可以通过按 Esc 拒绝命令。
在 Cursor 工具里，上下文（Context） 可理解为让 AI 准确理解需求、辅助编码的信息参考范围，是 AI 读懂代码、精准响应的关键。
打开项目文件夹时，每个 Cursor 实例都将初始化该工作区的索引。
初始索引设置完成后，Cursor 将自动为添加到工作区的任何新文件编制索引，以保证当前是最新的代码库上下文。
作用：
getUser 时，知道优先查 userService.js）Order 类和 Product 类的关联）AI 分析索引内容后，生成代码时会更贴合项目实际（如使用已有工具函数、遵循命名规范）。
代码库索引的配置位于：Cursor Settings > Indexing & Docs
测试示例：
查看当前项目结构，并使用文字图形形式罗列出来
展示效果：
Cursor 会读取项目的代码库并为其编制索引以支持其功能。可以通过将 .cursorignore 文件添加到项目根目录来控制哪些文件被忽略和限制 Cursor 访问。
作用：
node_modules、dist）配置 .cursorignore 忽略文件的两种方式：
.cursorignore 文件，并列出要忽略的目录和文件Cursor Settings > Indexing & Docs > Ignored Files in .cursorignore忽略文件配置测试：
1、创建忽略文件
2、添加忽略文件配置
# Add directories or file patterns to ignore during indexing (e.g. foo/ or *.csv)
main.js
ArrayDemo.class
3、测试
查看当前项目结构，并使用文字图形形式罗列出来
4、效果展示，可以看到对应的文件已经被忽略了
Rules 是给 Cursor AI 功能（规则适用于 Chat 和内联智能修改）生成的代码结果添加规则和限制，让 AI 生成的代码贴合团队规范，减少人工二次修改成本。
作用：
Rule 主要的配置方案有两种：
| 维度 | 项目规则（Project Rules） | 用户规则（User Rules） |
|---|---|---|
| 作用范围 | 仅对当前项目生效，团队成员共享相同规则 | 对所有项目生效，个人专属配置 |
| 存储位置 | 项目根目录下的 .cursor/rules/随意.mdc 文件 |
用户配置目录（如 ~/.cursor/rules） |
| 同步方式 | 随项目代码提交到版本库（如 Git），团队共享 | 仅本地生效，不随项目同步 |
| 适用场景 | 统一团队编码规范（如函数注释格式、依赖版本） | 个人习惯（如快捷键、AI 响应风格） |
注意：项目规则和用户规则同时存在并且规则冲突，项目规则优先级更高。
1、项目下创建规则文件
可通过如下两种方式进行创建：
项目/.cursor/rules/随意命名.mdcCtrl + Shift + P 唤起命令面板，然后输入New Cursor Rule，输入规则文件名，进行创建
2、编写项目规则文件
---
description: "团队前端项目规范"
priority: 1000
---
# 代码风格
1. 函数必须包含 JSDoc 注释
2. 禁止使用 `var`, 统一用 `const`/`let`
3. 函数命名必须添加 code_ 前缀，例如：code_login
# 依赖管理
- 优先使用项目内已有的工具函数（如 `utils/request`）
- 禁止引入低版本的 lodash（规则文件的语法后文会介绍。
3、创建一个 test.js 文件，使用内联智能修改功能生成代码
生成两个方法一个登录一个注册
4、项目规则生效效果展示
1、用户规则在 Cursor Settings > Rules & Memories 中定义
2、添加规则内容
3、用户规则不支持 MDC, 只是纯文本
Cursor 的 MDC（Markdown with Cursor）语法是专门为编写项目规则设计的轻量级格式，结合了 Markdown 的可读性和元数据配置能力。
1、前置元数据（Frontmatter）
--- 包裹的 YAML 格式配置2、规则内容（Markdown 正文）：用 Markdown 语法写具体规则
---
# 官方约定字段（推荐用，AI 更易理解）
description: "前端项目规则"
globs: "src/**/*.tsx"
priority: 1000
# 自定义字段（自己或团队约定含义）
author: "技术团队"
review_date: "2025-06-04"
special_rule: "仅周一至周五生效"
---
常用元数据字段
| 字段 | 作用 | 示例 |
|---|---|---|
description |
描述规则用途，指导 AI 如何应用规则 | "前端组件编码规范" |
globs |
指定规则生效的文件范围（支持 glob 语法） | "src/**/*.{js,ts,jsx}" |
priority |
规则优先级（数值越大越优先），解决规则冲突 | 1000 |
version |
规则版本号（可选） | "1.0.0" |
用 Markdown 的标题、列表、代码块等语法写具体规则，常见结构：
# 一、代码风格
1. 函数必须包含 JSDoc 注释
- 至少包含 `@param` 和 `@return` 描述
2. 变量命名必须使用驼峰命名法（camelCase）
3. 每行代码长度不超过 120 个字符
# 二、技术选型
- 禁止直接使用原生 fetch，必须通过项目封装的 request 工具
- 优先使用 React Hooks 而非 Class 组件
# 安全规范
1. 禁止使用 eval() 函数
2. SQL 查询必须使用参数化查询，防止注入攻击
3. 敏感信息（如 API 密钥）必须从环境变量读取
用 @file 引用项目内的配置文件，让 AI 参考：
# 工具链配置
1. ESLint 规则必须符合 @file .eslintrc.js
2. 测试用例必须遵循 Jest 框架规范
---
description: "TypeScript 项目编码规范"
globs: "src/**/*.ts"
priority: 1000
---
# 一、基础规范
1. 所有文件必须使用 UTF-8 编码
2. 统一使用 2 空格缩进
# 二、类型约束
1. 禁止使用隐式 any 类型
- 示例：`const num: number = 123`（显式）
- 禁止：`const num = 123`（隐式）
2. 接口命名必须以 `I` 开头（如 `interface IUser`）
# 三、项目约束
- 所有 HTTP 请求必须通过 @file src/utils/request.ts 封装的工具
- 状态管理必须使用 Redux Toolkit，禁止直接修改 state
在 Cursor 的 Chat 和内联智能修改功能中可以使用 @ 符号中引用代码、文件、文档和其他上下文的指南，直接更具体的指定上下文环境。
以下是所有可用 @ 符号的列表：
1、准备测试文件 test.js
/**
* 用户登录方法
* @param {string} username 用户名
* @param {string} password 密码
* @returns {Promise2、测试 @Test.js 对话
总结下 @test.js 里面的方法
3、查看对话结果
1、还是使用前文的 test.js 文件
2、测试 @Code 对话
帮我逐行解释下 @zwf_register 代码的含义！并且最终在源文件中添加注释！
3、查看对话结果
1、@Docs 作用说明
@Docs 将 Cursor 连接到来自常用工具和框架的官方文档，当需要以下内容的最新权威信息时，请使用它：
2、@Docs 文档配置
可以通过 Cursor Settings > Indexing & Docs 来进行文档索引配置。
点击 Add Doc 输入文档地址，如添加 MyBatis-Plus 官网地址：
https://baomidou.com/introduce/
MyBatis-Plus，就是用框架名称作为文档标识，后续可通过这个 name 快速找到、关联对应的文档配置。https://baomidou.com, 该框架文档介绍板块的基础前缀，后续若要拼接具体文档子页面路径（如某个功能详细说明路径 ），可以基于这个 prefix 去扩展，让文档地址管理更规整。https://baomidou.com/introduce/ 就是MyBatis-Plus文档的起始访问页面，用户通过这个 entrypoint 能直接进入到对应文档内容开始浏览。3、测试 @Docs 对话
@MyBatis-Plus 查询下乐观锁的使用
4、查看对话结果
1、@Web 作用说明
@Web 提供联网搜索当前信息、博客文章和社区讨论等资料的功能。
在特殊的场景下使用，如：
2、测试 @Web 对话
@Web Java17 有哪些新特性
3、查看对话结果
4、对比 @Docs 和 MCP 配置的区别
1、@Linter Errors 作用和说明
@Linter Errors 符号会自动捕获并提供有关当前活动文件中的任何 linting 错误和警告的上下文。
2、准备代码 BubbleSort.java
public class BubbleSort {
/**
* 冒泡排序方法
* @param arr 待排序的数组
*/
public static void bubbleSort(int[] arr) {
int n = arr.length;
// 外层循环控制排序轮数
for (int i = 0; i arr[j + 1]) {
int temp = arr[j];
arr[j] = arr[j + 1];
arr[j + 1] = temp;
}
}
}
}
/**
* 打印数组的辅助方法
* @param arr 要打印的数组
*/
public static void printArray(int[] arr) {
for (int i = 0; i 3、运行后，出现如下错误
4、使用 @Lint Errors 对话结局 Bug
@Linter Errors 程序运行报错了，基于报错信息分析下，并直接解决下错误
4、测试结果
登录查看全部
参与评论
手机查看
返回顶部