Cursor使用规范

710 字约 2 分钟

domain/aiai/coding

2026-07-24

1. 核心结论

Cursor 是基于 VS Code 的 AI 原生代码编辑器，深度集成 AI 能力
Cursor 提供代码补全、对话编辑、代码库理解等核心功能
Cursor 的 Composer 功能支持多文件协同编辑
善用 @ 符号引用文件、文档和代码库上下文
Cursor 适合个人开发者和小型团队快速开发

2. 基础概念

Cursor Editor：AI 原生的代码编辑器，基于 VS Code 构建。

Tab Completion：Tab 键代码补全，AI 预测下一段代码。

Chat：侧边栏对话，与 AI 讨论代码问题。

Composer：多文件编辑模式，AI 同时修改多个文件。

Codebase Index：代码库索引，AI 理解整个项目结构。

@ Reference：引用符号，指定文件、文件夹或文档作为上下文。

3. 工作原理

Cursor 核心功能：

代码补全（Tab）：
- 根据上下文预测代码
- 支持单行和多行补全
- 按 Tab 接受，按 Esc 拒绝
AI 对话（Chat）：
- 在侧边栏与 AI 对话
- 可以引用代码文件
- AI 回答可以应用到代码中
Composer 模式：
- 多文件协同编辑
- AI 理解项目结构
- 一次性修改多个文件
代码库理解：
- 自动索引代码库
- 支持跨文件引用
- 理解依赖关系

使用技巧：

上下文引用：
- @文件名：引用特定文件
- @文件夹：引用整个文件夹
- @Docs：引用官方文档
- @Codebase：引用整个代码库
编辑模式：
- Cmd+K：在当前文件编辑
- Cmd+L：打开聊天
- Cmd+I：打开 Composer
最佳实践：
- 保持代码库索引更新
- 使用有意义的文件命名
- 添加必要的注释
- 定期审查 AI 修改

配置建议：

{
  "cursor.cpp.enabled": true,
  "cursor.tabAutocompleteModel": "claude-3.5-sonnet",
  "cursor.chat.model": "claude-3.5-sonnet"
}

4. 实战场景

新功能开发
代码重构
Bug 修复
代码审查
文档编写
学习新框架

5. 常见误区

不开启代码库索引：AI 无法理解项目上下文
不使用 @ 引用：AI 缺乏必要的上下文
盲目接受补全：补全代码可能有错误
不审查 Composer 修改：多文件修改需要仔细检查
忽视隐私设置：代码会发送到 AI 服务

6. 进阶方向

自定义 AI 规则
团队共享配置
MCP Server 集成
私有模型部署
企业级安全配置
工作流自动化

7. 推荐资料

Cursor Docs - https://docs.cursor.com/
Cursor Features - https://www.cursor.com/features
Cursor Rules - https://docs.cursor.com/context/rules-for-ai

8. 关联笔记