从零构建高效开发环境：Cursor Rules与@符号的实战指南

1. 为什么需要规则与符号的协同

在团队协作开发中，代码风格统一和开发效率提升是永恒的话题。想象一下这样的场景：新成员加入项目后，花了两天时间才弄明白代码规范；或者每次提交代码前，都要手动检查几十条TypeScript类型约束。这些痛点正是Cursor的Rules和@符号设计要解决的。

Cursor通过两种机制重塑开发流程：

1. Rules：相当于项目的"宪法"，用MDC格式定义编码规范、技术栈约束等规则
2. @符号：像智能快捷键，快速调用文件、代码片段、文档等上下文

当二者结合时，会产生奇妙的化学反应。比如定义"禁止隐式any"的规则后，输入@Lint Errors就能自动修复类型错误，这比传统IDE的静态检查更主动。

2. 项目规范体系构建

2.1 初始化规则文件

在项目根目录执行以下命令生成规则模板：

# 通过Cursor命令面板生成初始配置
mkdir -p .cursor/rules && touch .cursor/rules/project-rules.mdc

典型的MDC规则文件结构如下：

---
alwaysApply: true
description: "TypeScript全栈项目规范"
globs: ["**/*.ts","**/*.tsx"]
priority: 1000
---

# 代码风格
1. 使用2空格缩进
2. 字符串统一使用单引号
3. 接口命名前缀`I`(如`IUserModel`)

# 类型约束
- 禁用隐式any：必须显式声明类型  
  ```ts
  // 允许
  const count: number = 123
  
  // 禁止 
  const count = 123

### 2.2 规则优先级管理

Cursor支持多规则文件协同工作，优先级策略如下：

| 规则类型 | 路径 | 优先级 | 生效范围 |
|---------|------|--------|----------|
| 项目规则 | .cursor/rules/*.mdc | 高 | 全项目 |
| 用户规则 | ~/.cursor/rules/ | 低 | 仅本地 |

当规则冲突时，优先级数值大的生效。建议团队共享的核心规则设置为1000，个人偏好设为100-500。

## 3. @符号的实战应用

### 3.1 高频符号速查表

| 符号 | 快捷键 | 使用场景示例 |
|------|--------|--------------|
| @Files | ⌘+拖拽文件 | 引用具体实现文件 |
| @Code | 选中代码+⌘L | 聚焦特定代码段 |
| @Lint Errors | 终端报错时使用 | 自动修复类型错误 |
| @Cursor Rules | 输入@后选择 | 查看当前生效规则 |

### 3.2 典型工作流示例

**场景**：接到修改用户登录功能的任务

1. 通过`@Files src/features/auth`快速定位相关模块
2. 输入指令：

检查当前实现是否符合安全规范 @Cursor Rules

3. 发现报错后：

修复这个类型错误 @Lint Errors

4. 需要参考历史方案时：

显示上次修改记录 @Git HEAD~3

这种工作流比传统文件跳转+手动检查效率提升3倍以上。

## 4. 高级集成技巧

### 4.1 自定义文档关联

在`.cursor/settings.json`中添加：
```json
{
"docs": {
 "jwt": "https://jwt.io/introduction",
 "redux": "https://redux-toolkit.js.org/api/createSlice"
}
}

之后可通过@Docs jwt直接引用官方文档，结合规则中的技术栈约束，确保方案一致性。

4.2 智能补全配置

在VSCode的settings.json中加入：

{
  "editor.quickSuggestions": {
    "other": "on",
    "comments": "off",
    "strings": "on" 
  }
}

这样在字符串内输入@也会触发符号提示，特别适合在注释中追加文档引用。

5. 避坑指南

实际使用中遇到过几个典型问题：

1. 规则不生效：检查.cursorignore是否排除了规则文件
2. 符号无响应：确认文件已保存，未保存文件不会被索引
3. 性能问题：对node_modules等目录添加忽略规则

有个特别有用的技巧：当不确定哪些规则生效时，输入@Cursor Rules会显示当前应用的所有规则及其优先级，这比查文档更直接。