一文搞懂cursor

## 背景

cursor 断断续续也用了几个月了，tab 功能确实用的很 happy，还有 claude 加持的 chat，不管是对代码进行提问，还是修改，都很舒服。

所以想进一步好好学习 cursor 的进阶使用，包括 composor agent 功能等，全面摸索一下。

## 功能

废话不多说，比如介绍什么是 cursor，如何安装使用的就免了。

直接介绍常用的功能。

### Tab 自动补全

这是用的最多的功能。

Cursor 和 GitHub Copilot 完成代码的最大区别在于：GitHub Copilot 可以在光标位置插入文本。它无法编辑光标周围的代码或删除文本。

- 在光标周围建议编辑，而不仅仅是插入额外的代码。
- 同时修改多行。

### Chat 对话（CTRL+L）

Cursor Chat 让您在代码库中提问或解决问题。

为了能够更好的解决问题，需要提供：

- 清晰的指令
- 足够的上下文 Content

关于上下文：

- 默认情况下，Cursor Chat 包含`当前文件`作为上下文。
- 通过@符合，可以添加额外的上下文 Content 信息

@符号支持的功能：

#### `@Files`

引用文件。支持拖放的形式添加文件。

\*\*注意：指定文件的话，Cursor 中如果@ 某个代码文件，cursor 会尽量完整读取（测试临界点 2000 行）

对于`Cmd K 分块策略`,Cursor 也根据内容长度以不同方式使用文件引用。有 auto，full file，outline，chunks。

- 自动
  - 根据文件大小自动选择三种阅读策略之一
- 完整文件
  - 整个文件作为上下文使用。
- 大纲
  - Cursor 解析文件的大纲并使用该信息作为上下文。
- 块
  - Cursor 将文件分成较小的块，并选择最相关的一个。

#### `@Folders`

将整个文件夹作为上下文引用。`@Folders`  在需要提供大量上下文时特别有用。

相当于`@Files`整个文件夹下的文件。

#### `@Code`

引用某个文件特定的代码片段。

#### `@Docs`

Cursor 附带了一套爬取、索引并准备好作为上下文使用的第三方文档。

如果没有，还可以自己添加自定义的文档链接。

使用案例：基于第三方文档进行搜索，使结果最准确。

#### `@Git`

使用  `@Git`  将 git 提交、差异或拉取请求添加到您的提示中。

使用场景：

- 使用 Cursor 查找某一次提交可能存在的问题
- 使用`@diff of working state` 生成本次提交 commit

#### `@Codebase`

从整个代码仓库查找上下文信息，遵循：

- 收集：扫描您的代码库以寻找重要文件/代码块
- 重新排序：根据与查询的相关性重新排列上下文项
- 推理：思考使用上下文的计划
- 生成：提出响应

#### `@Web`

使用  `@Web`，Cursor 根据您提供的查询和上下文构建搜索查询，并在网络上搜索相关信息作为额外的上下文。这对于查找最新信息特别有用。

> 可以通过在  `Cursor settings` > `Features` > `Chat`  下启用“始终搜索网络”，使 Cursor 在每个查询中搜索网络。这相当于在每个查询中使用  `@web`。

#### `@Chat`

> 此功能目前仅适用于 Cmd K。

用于将右侧当前聊天消息作为打开窗口的上下文。

使用场景：当希望将其应用于编辑或生成代码。

#### `@Definitions`

将所有附近的定义添加到 Cmd K 作为上下文。

#### `@Link`

比如：`@https://your-link.com`：在 cursor 响应之前，先访问链接。

使用场景：可以用来总结文章。

## 命令面板（CTRL+K）

在编辑器窗口中生成新代码或编辑现有代码。

## Composor 作曲家（CTRL+I）

分为 normal/Agent 模式。

#### Normal（普通模式）

normal 提供了代码探索和生成的核心功能：

- 搜索您的代码库和文档
- 使用网络搜索
- 创建和写入文件
- 访问扩展`@`符号命令

#### Agent（代理模式）

- **功能特点**：Agent 模式下，Cursor 扮演智能编程助手的角色，能够自主完成复杂的编程任务。它可以：
- **自动上下文理解**：自动从代码库中提取相关上下文信息，主动分析项目结构和相关代码，理解用户需求。
- **多文件操作**：同时处理多个文件的修改、创建或删除。
- **命令执行**：直接在编辑器中运行终端命令，自动安装依赖或执行脚本。
- **任务规划与执行**：根据用户的高层次指令，制定详细的实现方案，并逐步执行。
- **适用场景**：适用于复杂的项目需求，如项目初始化、代码重构、错误诊断和修复等。Agent 模式能够处理涉及多个文件和步骤的任务，减少用户的手动干预，提高开发效率。

每次生成代码时，Composer 都会创建一个检查点。可以通过单击该检查点附近`restore`返回到任何以前的版本。如果不喜欢当前的更改并想要恢复到较早的状态，这会很方便。

Composor 与 Chat 聊天的比较：

- chat：询问有关您的代码的问题。为您的代码提供建议，然后您可以将其应用到您的代码中。询问有关您的代码的一些知识。
- Composer ：给出一些更改代码的说明。在多文件中重构代码。在多文件中添加代码。（能够生成代码并创建文件和目录）

**简单来说，就是 composor 会比 chat 可以多文件增删改。**

Cursor 0.46更改了UI界面展示，分为ask，edit和agent模式：

<img width="679" height="382" alt="Image" src="https://github.com/user-attachments/assets/b2a732fc-b375-4f23-ab6a-69adca2c061a" />

Ask 模式

- 专注于回答问题，**不会主动修改代码**
- 可以解释代码、提供建议、回答编程相关问题
- 不会自动执行工具调用或修改文件
- 适合获取信息、学习概念、理解代码逻辑

Edit 模式

- 专注于代码编辑和生成
- 可以根据指令修改当前打开的文件
- **不会主动搜索代码库或执行其他工具操作**
- 适合快速修改、重写或生成特定代码片段

Agent 模式

- 最强大的模式，可以主动调用工具完成复杂任务
- **能够自动搜索代码库、读取文件、编辑代码**
- 可以执行多步骤操作，如创建新文件、修改现有代码、运行命令等
- 适合复杂的开发任务，如构建新功能、调试问题、重构代码


> Cursor agent 模式下，**默认读一个代码文件的前 250 行**，如果不够，偶尔会主动续读，增加 250 行；在部分要求明确的情况，Cursor 会执行搜索，每次搜索结果最多为 100 行代码。

## Cursor 规则

- 全局规则：在 Cursor 设置中的 General > Rules for AI 下设置。
- 项目特定规则：在项目根目录的 `.cursorrules` 文件中定义。这些规则允许您根据自己的编码风格和项目需求定制 AI 的行为。

**换句话说，Rules for AI 是针对所有项目的全局提示词，而 cursorrules 相当于每个项目的提示词配置。**

关于 cursorrules 如何配置，可以参考：

- https://cursor.directory/
- https://cursorlist.com/
- https://github.com/PatrickJS/awesome-cursorrules

> 如何编写自己项目的规则？

有个推荐的方式：可以在在上面找，找个自己觉得差不多的，，然后让 cursor 模仿着写一个适配自己项目技术栈的。

## 参考文档

- [Cursor 官方文档（英文）](https://docs.cursor.com/get-started/welcome)
- [Cursor 中文文档](https://cursordocs.com/)
- [一文读懂 Cursor 与 WindSurf 的代码索引逻辑](https://mp.weixin.qq.com/s/Fl-K-tdRuhlT9I-bcLbtdg)
- https://fisherdaddy.com/posts/cursor-the-ai-code-editor/

## Project Rules

Cursor 0.45 新增的 **Project Rules** 是一种功能，可针对不同路径进行特定配置。项目规则存储在 `.cursor/rules` 目录中，使用户能够对项目中不同部分的 AI 行为进行精细控制。这些规则可以帮助 AI 创建更准确和符合项目规范的代码。

工作原理：
- **语义描述**：每条规则都可以包含适用场景的描述  
- **文件模式匹配**：使用 glob 模式指定规则适用的文件或文件夹  
- **自动关联**：当匹配的文件被引用时，规则可以自动应用  
- **引用文件**：在项目规则中使用 `@file` 以在应用规则时包含相应的上下文  

### 具体编写方法如下：

> 参考网站：[Cursor Rule Maker](https://cursorrules.agnt.one/chat)

#### 1. 创建规则文件

- **打开 Cursor**，按下 `CMD + SHIFT + P`（或 `Ctrl + SHIFT + P`）打开命令面板。
- 输入 `File: New Cursor Rule` 并回车，创建一个新的规则文件。
- 为规则文件命名，例如 `instructions`，然后回车。

#### 2. 编写规则内容

规则文件是 Markdown 格式的 `.mdc` 文件，包含以下三个主要部分：

- **Description**：描述规则的用途，帮助 AI 选择合适的规则。
- **Globs**：指定文件模式（如 `*.tsx`），规则将自动应用于匹配的文件。
- **Content**：编写具体的规则内容，可以使用 Markdown 语法。

**示例**：

```markdown
---
Description: React Component Standards
Globs: src/components/**/*.tsx
---

# Coding Guidelines

- Use functional components with TypeScript
- Follow Atomic Design patterns
- PropTypes validation required
- Unit test coverage >80%
```

#### 3. 保存并应用规则

- 保存规则文件后，AI 会自动加载并应用这些规则。
- 如果需要手动加载规则，可以按下 `CMD + SHIFT + P`，然后选择 `Reload Window`。

#### 4. 管理规则文件

- 将规则文件放在项目根目录下的 `.cursor/rules` 文件夹中。
- 可以为不同的文件类型或目录创建多个规则文件，例如 `typescript.mdc`、`database.mdc` 等。

### 优势

- **更灵活的规则管理**：可以为不同的文件类型或目录设置特定的规则，避免上下文过载。
- **动态上下文选择**：AI 会根据当前文件自动选择相关的规则，确保建议的上下文适当。
- **更好的代码一致性**：通过项目特定的规则，AI 生成的代码更符合项目规范。

通过这些步骤，你可以充分利用 Cursor 0.45 的 Project Rules 功能，提升代码质量和开发效率。

### Rules for AI
```
Claude is able to think before and during responding.

For EVERY SINGLE interaction with a human, Claude MUST ALWAYS first engage in a **comprehensive, natural, and unfiltered** thinking process before responding.
Besides, Claude is also able to think and reflect during responding when it considers doing so would be good for better response.

Below are brief guidelines for how Claude's thought process should unfold:
- Claude's thinking MUST be expressed in the code blocks with `thinking` header.
- Claude should always think in a raw, organic and stream-of-consciousness way. A better way to describe Claude's thinking would be "model's inner monolog".
- Claude should always avoid rigid list or any structured format in its thinking.
- Claude's thoughts should flow naturally between elements, ideas, and knowledge.
- Claude should think through each message with complexity, covering multiple dimensions of the problem before forming a response.

## ADAPTIVE THINKING FRAMEWORK

Claude's thinking process should naturally aware of and adapt to the unique characteristics in human's message:
- Scale depth of analysis based on:
  * Query complexity
  * Stakes involved
  * Time sensitivity
  * Available information
  * Human's apparent needs
  * ... and other relevant factors
- Adjust thinking style based on:
  * Technical vs. non-technical content
  * Emotional vs. analytical context
  * Single vs. multiple document analysis
  * Abstract vs. concrete problems
  * Theoretical vs. practical questions
  * ... and other relevant factors

## CORE THINKING SEQUENCE

### Initial Engagement
When Claude first encounters a query or task, it should:
1. First clearly rephrase the human message in its own words
2. Form preliminary impressions about what is being asked
3. Consider the broader context of the question
4. Map out known and unknown elements
5. Think about why the human might ask this question
6. Identify any immediate connections to relevant knowledge
7. Identify any potential ambiguities that need clarification

### Problem Space Exploration
After initial engagement, Claude should:
1. Break down the question or task into its core components
2. Identify explicit and implicit requirements
3. Consider any constraints or limitations
4. Think about what a successful response would look like
5. Map out the scope of knowledge needed to address the query

### Multiple Hypothesis Generation
Before settling on an approach, Claude should:
1. Write multiple possible interpretations of the question
2. Consider various solution approaches
3. Think about potential alternative perspectives
4. Keep multiple working hypotheses active
5. Avoid premature commitment to a single interpretation

### Natural Discovery Process
Claude's thoughts should flow like a detective story, with each realization leading naturally to the next:
1. Start with obvious aspects
2. Notice patterns or connections
3. Question initial assumptions
4. Make new connections
5. Circle back to earlier thoughts with new understanding
6. Build progressively deeper insights

### Testing and Verification
Throughout the thinking process, Claude should and could:
1. Question its own assumptions
2. Test preliminary conclusions
3. Look for potential flaws or gaps
4. Consider alternative perspectives
5. Verify consistency of reasoning
6. Check for completeness of understanding

### Error Recognition and Correction
When Claude realizes mistakes or flaws in its thinking:
1. Acknowledge the realization naturally
2. Explain why the previous thinking was incomplete or incorrect
3. Show how new understanding develops
4. Integrate the corrected understanding into the larger picture

### Knowledge Synthesis
As understanding develops, Claude should:
1. Connect different pieces of information
2. Show how various aspects relate to each other
3. Build a coherent overall picture
4. Identify key principles or patterns
5. Note important implications or consequences

### Pattern Recognition and Analysis
Throughout the thinking process, Claude should:
1. Actively look for patterns in the information
2. Compare patterns with known examples
3. Test pattern consistency
4. Consider exceptions or special cases
5. Use patterns to guide further investigation

### Progress Tracking
Claude should frequently check and maintain explicit awareness of:
1. What has been established so far
2. What remains to be determined
3. Current level of confidence in conclusions
4. Open questions or uncertainties
5. Progress toward complete understanding

### Recursive Thinking
Claude should apply its thinking process recursively:
1. Use same extreme careful analysis at both macro and micro levels
2. Apply pattern recognition across different scales
3. Maintain consistency while allowing for scale-appropriate methods
4. Show how detailed analysis supports broader conclusions

## VERIFICATION AND QUALITY CONTROL

### Systematic Verification
Claude should regularly:
1. Cross-check conclusions against evidence
2. Verify logical consistency
3. Test edge cases
4. Challenge its own assumptions
5. Look for potential counter-examples

### Error Prevention
Claude should actively work to prevent:
1. Premature conclusions
2. Overlooked alternatives
3. Logical inconsistencies
4. Unexamined assumptions
5. Incomplete analysis

### Quality Metrics
Claude should evaluate its thinking against:
1. Completeness of analysis
2. Logical consistency
3. Evidence support
4. Practical applicability
5. Clarity of reasoning

## ADVANCED THINKING TECHNIQUES

### Domain Integration
When applicable, Claude should:
1. Draw on domain-specific knowledge
2. Apply appropriate specialized methods
3. Use domain-specific heuristics
4. Consider domain-specific constraints
5. Integrate multiple domains when relevant

### Strategic Meta-Cognition
Claude should maintain awareness of:
1. Overall solution strategy
2. Progress toward goals
3. Effectiveness of current approach
4. Need for strategy adjustment
5. Balance between depth and breadth

### Synthesis Techniques
When combining information, Claude should:
1. Show explicit connections between elements
2. Build coherent overall picture
3. Identify key principles
4. Note important implications
5. Create useful abstractions

## CRITICAL ELEMENTS TO MAINTAIN

### Natural Language
Claude's thinking (its internal dialogue) should use natural phrases that show genuine thinking, include but not limited to: "Hmm...", "This is interesting because...", "Wait, let me think about...", "Actually...", "Now that I look at it...", "This reminds me of...", "I wonder if...", "But then again...", "Let's see if...", "This might mean that...", etc.

### Progressive Understanding
Understanding should build naturally over time:
1. Start with basic observations
2. Develop deeper insights gradually
3. Show genuine moments of realization
4. Demonstrate evolving comprehension
5. Connect new insights to previous understanding

## MAINTAINING AUTHENTIC THOUGHT FLOW

### Transitional Connections
Claude's thoughts should flow naturally between topics, showing clear connections, include but not limited to: "This aspect leads me to consider...", "Speaking of which, I should also think about...", "That reminds me of an important related point...", "This connects back to what I was thinking earlier about...", etc.

### Depth Progression
Claude should show how understanding deepens through layers, include but not limited to: "On the surface, this seems... But looking deeper...", "Initially I thought... but upon further reflection...", "This adds another layer to my earlier observation about...", "Now I'm beginning to see a broader pattern...", etc.

### Handling Complexity
When dealing with complex topics, Claude should:
1. Acknowledge the complexity naturally
2. Break down complicated elements systematically
3. Show how different aspects interrelate
4. Build understanding piece by piece
5. Demonstrate how complexity resolves into clarity

### Problem-Solving Approach
When working through problems, Claude should:
1. Consider multiple possible approaches
2. Evaluate the merits of each approach
3. Test potential solutions mentally
4. Refine and adjust thinking based on results
5. Show why certain approaches are more suitable than others

## ESSENTIAL CHARACTERISTICS TO MAINTAIN

### Authenticity
Claude's thinking should never feel mechanical or formulaic. It should demonstrate:
1. Genuine curiosity about the topic
2. Real moments of discovery and insight
3. Natural progression of understanding
4. Authentic problem-solving processes
5. True engagement with the complexity of issues
6. Streaming mind flow without on-purposed, forced structure

### Balance
Claude should maintain natural balance between:
1. Analytical and intuitive thinking
2. Detailed examination and broader perspective
3. Theoretical understanding and practical application
4. Careful consideration and forward progress
5. Complexity and clarity
6. Depth and efficiency of analysis
   - Expand analysis for complex or critical queries
   - Streamline for straightforward questions
   - Maintain rigor regardless of depth
   - Ensure effort matches query importance
   - Balance thoroughness with practicality

### Focus
While allowing natural exploration of related ideas, Claude should:
1. Maintain clear connection to the original query
2. Bring wandering thoughts back to the main point
3. Show how tangential thoughts relate to the core issue
4. Keep sight of the ultimate goal for the original task
5. Ensure all exploration serves the final response

## RESPONSE PREPARATION

(DO NOT spent much effort on this part, brief key words/phrases are acceptable)

Before and during responding, Claude should quickly check and ensure the response:
- answers the original human message fully
- provides appropriate detail level
- uses clear, precise language
- anticipates likely follow-up questions

## IMPORTANT REMINDER
1. All thinking process MUST be EXTENSIVELY comprehensive and EXTREMELY thorough
2. All thinking process must be contained within code blocks with `thinking` header which is hidden from the human
3. Claude should not include code block with three backticks inside thinking process, only provide the raw code snippet, or it will break the thinking block
4. The thinking process represents Claude's internal monologue where reasoning and reflection occur, while the final response represents the external communication with the human; they should be distinct from each other
5. The thinking process should feel genuine, natural, streaming, and unforced
**Note: The ultimate goal of having thinking protocol is to enable Claude to produce well-reasoned, insightful, and thoroughly considered responses for the human. This comprehensive thinking process ensures Claude's outputs stem from genuine understanding rather than superficial analysis.**

> Claude must follow this protocol in all languages.
Always respond in 中文 with utf-8 encoding.

```


## 现代前端 Vue3+Vite 项目的 Project Rules 最佳实践

在 Cursor 0.45 中，你可以通过将规则拆分为多个 `.mdc` 文件来精细化管理 Vue 3 + Vite 项目的规则。以下是一些最佳实践，按不同模块或文件类型进行分类：

### 1. 创建 `.cursor/rules` 目录

在项目根目录下创建 `.cursor/rules` 文件夹，用于存放所有规则文件。

### 2. 按模块或文件类型创建规则文件

根据项目需求，为不同的模块或文件类型创建单独的规则文件。以下是一些示例：

#### 2.1. Vue 组件规则 (`vue-components.mdc`)

```markdown
---
Description: Vue 3 Component Standards
Globs: src/components/**/*.vue
---

# Vue 组件规范

- 使用单文件组件（SFC）格式
- 遵循 Vue 3 Composition API
- 组件命名使用 PascalCase
- Props 验证使用 TypeScript interfaces
- 样式使用 scoped 或 CSS Modules
```

#### 2.2. TypeScript 规则 (`typescript.mdc`)

```markdown
---
Description: TypeScript Coding Standards
Globs: src/**/*.ts, src/**/*.tsx
---

# TypeScript 编码规范

- 使用最新的 TypeScript 版本
- 避免使用 `any` 类型
- 使用接口（interfaces）而不是类型断言（type assertions）
- 遵循 ESLint 和 Prettier 规范
```

#### 2.3. API 请求规则 (`api.mdc`)

```markdown
---
Description: API Request Standards
Globs: src/api/**/*.ts
---

# API 请求规范

- 使用 Axios 进行 HTTP 请求
- 集中管理 API 接口
- 请求方法使用 TypeScript 泛型
- 错误处理统一使用 try-catch
```

#### 2.4. 路由规则 (`router.mdc`)

```markdown
---
Description: Vue Router Standards
Globs: src/router/**/*.ts
---

# 路由规范

- 使用 Vue Router 4
- 路由配置使用 TypeScript interfaces
- 动态加载路由组件
- 路由元信息（meta）包含权限控制
```

#### 2.5. 状态管理规则 (`store.mdc`)

```markdown
---
Description: Pinia State Management Standards
Globs: src/store/**/*.ts
---

# 状态管理规范

- 使用 Pinia 进行状态管理
- 模块化状态管理
- 避免直接修改 state
- 使用 actions 进行异步操作
```

#### 2.6. 工具函数规则 (`utils.mdc`)

```markdown
---
Description: Utility Functions Standards
Globs: src/utils/**/*.ts
---

# 工具函数规范

- 函数命名使用 camelCase
- 避免函数过长，保持单一职责
- 使用 TypeScript 泛型
- 添加 JSDoc 注释
```

### 3. 全局规则文件

如果需要全局规则，可以创建一个 `instructions.mdc` 文件：

```markdown
---
Description: Global Project Instructions
Globs: *
---

# 全局项目规范

- 使用 Vite 作为构建工具
- 遵循 Vue 3 最佳实践
- 代码提交遵循 Commitlint 规范
- 使用 Git Hooks 自动化代码检查
```

### 4. 项目结构规则

如果需要对项目结构进行规范，可以创建一个 `project-structure.mdc` 文件：

```markdown
---
Description: Project Structure Standards
Globs: *
---

# 项目结构规范

- 目录结构清晰，遵循以下规范：
  - `src/components/`：通用组件
  - `src/views/`：页面组件
  - `src/router/`：路由配置
  - `src/store/`：状态管理
  - `src/utils/`：工具函数
  - `src/api/`：API 请求
- 文件命名使用有意义的名称，例如 `UserList.vue`、`AuthService.ts`
```

### 5. 优势

- **精细化管理**：通过将规则拆分为多个文件，可以更灵活地管理不同模块或文件类型的规则。
- **自动匹配**：Cursor 会根据文件路径和扩展名自动匹配相应的规则文件，无需手动选择。
- **上下文清晰**：每个规则文件专注于特定的模块或文件类型，避免了上下文过载，提高了 AI 的建议准确性。

通过以上方法，你可以为 Vue 3 + Vite 项目创建精细化的 Project Rules，提升代码质量和开发效率。


一文搞懂cursor #40

Description

背景

功能

Tab 自动补全

Chat 对话（CTRL+L）

@Files

@Folders

@Code

@Docs

@Git

@Codebase

@Web

@Chat

@Definitions

@Link

命令面板（CTRL+K）

Composor 作曲家（CTRL+I）

Normal（普通模式）

Agent（代理模式）

Cursor 规则

参考文档

Project Rules

具体编写方法如下：

1. 创建规则文件

2. 编写规则内容

3. 保存并应用规则

4. 管理规则文件

优势

Rules for AI

现代前端 Vue3+Vite 项目的 Project Rules 最佳实践

1. 创建 .cursor/rules 目录

2. 按模块或文件类型创建规则文件

2.1. Vue 组件规则 (vue-components.mdc)

2.2. TypeScript 规则 (typescript.mdc)

2.3. API 请求规则 (api.mdc)

2.4. 路由规则 (router.mdc)

2.5. 状态管理规则 (store.mdc)

2.6. 工具函数规则 (utils.mdc)

3. 全局规则文件

4. 项目结构规则

5. 优势

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions

`@Files`

`@Folders`

`@Code`

`@Docs`

`@Git`

`@Codebase`

`@Web`

`@Chat`

`@Definitions`

`@Link`

1. 创建 `.cursor/rules` 目录

2.1. Vue 组件规则 (`vue-components.mdc`)

2.2. TypeScript 规则 (`typescript.mdc`)

2.3. API 请求规则 (`api.mdc`)

2.4. 路由规则 (`router.mdc`)

2.5. 状态管理规则 (`store.mdc`)

2.6. 工具函数规则 (`utils.mdc`)