Cursor 从入门到精通

托尼吴

7024人浏览 · 2025-12-30 14:05:02

托尼吴 · 2025-12-30 14:05:02 发布

2.1: 基本介绍

Cursor – Welcome

Cursor 是一款功能强大的 AI 优先代码编辑器，可增强我们的开发工作流程。主要提供三个核心方向，这些功能可以无缝地协同工作，从而提高工作效率：

深度集成AI模型，不是简单地接入模型，而是让AI充当了编译器的核心交互方式。支持代码块对话、项目级对话、模型自由选择。
强上下文理解能力，可以自动识别项目文件、代码块、错误信息等等，提供更直观准确的AI修改能力。
对话式开发体验，仅需用自然语言沟通，Cursor就会根据指令完成布置的任务，使用者可以轻松扮演产品经理，让Cursor理解你的命令自行工作。

2.2： Cursor配置说明

2.2.1：配置

在 Cursor 中，Cursor Settings 和 Editor Settings 是两个不同的配置入口，分别用于管理 AI 功能和编辑器基础设置。

对比项	Cursor Settings	Editor Settings
功能定位	管理 AI 相关功能和 Cursor 特有设置	调整编辑器基础行为和外观
继承性	与 VS Code 差异较大（Cursor 独有功能）	大部分继承自 VS Code（如主题设置）
影响范围	影响 AI 代码生成、分析、对话的效果	影响代码编辑体验（如排版、颜色）
典型配置示例	调整 AI 模型参数、代码库索引路径	修改字体、启用自动保存、更改主题

2.5 Java语言环境

接下来，我们在Cursor中进行 Java 开发配置，包括设置 JDK、安装必要的扩展、调试、运行 Java 应用程序以及集成 Maven等构建工具。

2.2.2 配置本地jdk和maven配置

自动读取情况

如果 Cursor 基于类似 VS Code 的机制运行（Cursor 与 VS Code 有诸多关联），在系统环境变量中正确配置了 JAVA_HOME 和 MAVEN_HOME ，且环境变量配置无误（变量值准确指向 JDK 和 Maven 的安装目录），部分情况下 Cursor 能自动识别并应用这些配置。比如，当你在 Cursor 中创建、运行或调试 Java 项目时，它可能会利用自动读取到的环境变量来找到对应的 JDK 和 Maven 位置，完成代码编译、项目构建等操作。

手动配置情况

若 Cursor 没有自动读取到 JDK 和 Maven 配置，就需要手动配置。可在 settings.json 文件中进行操作。按 Ctrl + Shift + P （Windows/Linux）或 Cmd + Shift + P（Mac）打开命令面板，输入 “Preferences: Open User Settings (JSON)” 并回车，打开 settings.json 文件。然后添加或修改以下内容：

{
    "java.home": "你的 JDK 安装路径（对应 JAVA_HOME 变量值）",
    "java.configuration.maven.userSettings": "你的 Maven 配置文件 settings.xml 所在路径"
}

例如：

{
    "java.home": "C:/Program Files/Java/jdk-17",
    "java.configuration.maven.userSettings": "D:/maven/apache-maven-3.8.8-bin/apache-maven-3.8.8/conf/settings.xml"
}

保存文件后，重启 Cursor 使配置生效。

2.3：使用说明

2.3.1. 常用技巧

Tab相关配置说明

配置修改位置： cursor settings > features > tab

A powerful Copilot replacement that can suggest changes across multiple lines...
- 作用：启用 / 禁用 Cursor Tab 功能。
- 通俗理解：相当于 “总开关”，勾选后才能用 Tab 键触发 AI 代码建议（如多行补全、智能续写）；取消勾选则 Tab 仅作普通缩进。
Accept the next word of a suggestion via Ctrl+RightArrow
- 作用：开启后，可用 Ctrl+→（Windows/Linux）或 ⌘+→（Mac）逐个单词接受 AI 建议。
- 通俗理解：AI 给的建议很长时，不想全要？开这个功能，按快捷键 “挑着用”。
场景：比如 AI 建议 const fullName = firstName + " " + lastName;，但你只想用 firstName + " " + lastName 部分，就可通过该快捷键拆分接受。
Enable Cursor Tab suggestions in comments
- 作用：让 AI 在注释内容里也提供 Tab 建议。
- 通俗理解：写注释时，AI 帮你补全思路！比如输入 // 实现冒泡排序的步骤：，按 Tab 自动续写步骤说明。
Show whitespace only Cursor Tab suggestions
- 作用：控制是否显示仅包含空白（空格、换行）的 AI 建议。
- 通俗理解：这个配置项决定了当按 Tab 时，是否让那些 “只调整空格、换行、缩进（没有实际代码逻辑变化）” 的建议显示出来。。

按tab键 → Cursor 自动生成代码：

接受，接受部分和拒绝

crl + ->

2.3.2:Cursor精准上下文指定

文档索引

打开项目时，每个 Cursor 实例都将初始化该工作区的索引。初始索引设置完成后，Cursor 将自动为添加到工作区的任何新文件编制索引，以使您的代码库上下文保持最新：

快速 “读懂” 你的项目结构（哪些是工具文件、哪些是业务逻辑）
定位相关代码（如搜索 getUser 时，知道优先查 userService.js）
理解代码关系（如 Order 类和 Product 类的关联）

Cursor 中的作用：AI 分析索引内容后，生成代码时会更贴合项目实际（如使用已有工具函数、遵循命名

忽略文件配置

Cursor 读取项目的代码库并为其编制索引以支持其功能。可以通过将 .cursorignore 文件添加到根目录来控制哪些文件被忽略和Cursor限制访问。

提升索引速度：排除大型依赖、生成文件（如 node_modules、dist）
避免干扰：某些配置文件可能包含敏感信息或与当前任务无关

配置 .cursorignore忽略文件：

自己创建 .cursorignore 文件添加到代码库目录的根目录下，并列出要忽略的目录和文件
使用cursor配置快捷创建忽略文件 cursor setting > indexing > Configure ignored files

2.3.3：Rule 规则

Rules是给Cursor AI功能（规则适用于 Chat和 Cmd K）生成结果添加规则和限制，让 AI 生成的代码贴合团队规范，减少人工二次修改成本，主要的作用如下：

可约束代码风格（如强制用驼峰命名、要求函数必须写注释）
能限定技术选型（如禁止使用某老旧库、优先用项目指定工具类）
提前指定核心参数（如提前设置连接数据库的地址和账号密码等）

Rule主要的配置方案有两种：

维度	项目规则（Project Rules）	用户规则（User Rules）
作用范围	仅对当前项目生效，团队成员共享相同规则	对所有项目生效，个人专属配置
存储位置	项目根目录下的`.cursor/rules/随意.mdc` 文件	用户配置目录（如`~/.cursor/rules`）
同步方式	随项目代码提交到版本库（如 Git），团队共享	仅本地生效，不随项目同步
适用场景	统一团队编码规范（如函数注释格式、依赖版本）	个人习惯（如快捷键、AI 响应风格）

项目规则配置

---
description: "团队前端项目规范"
priority: 1000
---

# 代码风格
1. 函数必须包含 JSDoc 注释
2. 禁止使用 `var`，统一用 `const`/`let`
3. 函数命名必须添加 zwf_前缀， 例如：zwf_login

# 依赖管理
- 优先使用项目内已有的工具函数（如 `utils/request`）
- 禁止引入低版本的 lodash（<4.0.0）

用户规则配置

mdc语法了解

Cursor 的 MDC（Markdown with Cursor）语法是专门为编写项目规则设计的轻量级格式，它结合了 Markdown 的可读性和元数据配置能力。接下来，我们来说明下mdc文件语法。

MDC 文件组成部分：

前置元数据（Frontmatter）
- 用 --- 包裹的 YAML 格式配置
- 定义规则的基本属性（如作用范围、优先级）
规则内容（Markdown 正文）
- 用 Markdown 语法写具体规则

---
# 官方约定字段（推荐用，AI 更易理解）
description: "前端项目规则"
globs: "src/**/*.tsx"
priority: 1000

# 自定义字段（自己或团队约定含义）
author: "技术团队"
review_date: "2025-06-04"
special_rule: "仅周一至周五生效"
---


---
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