本指南整理自Cursor官方文档，涵盖Agent模式、Composer、快捷键配置、Context管理等高级功能，帮助开发者充分发挥Cursor的AI编程能力。
Agent是Cursor的AI助手核心功能，能够独立完成复杂的编码任务、执行终端命令和修改代码。通过Cmd+I（Mac）或Ctrl+I（Windows）打开侧边栏Agent面板。
| 模式 | 描述 | 适用场景 |
|---|
| Agent | 自主决策完成复杂任务 | 大型重构、多文件修改 |
| Composer | 协作式生成代码 | 新功能开发、代码生成 |
| Chat | 对话式问答 | 问题解答、代码解释 |
# 启动交互式会话
agent
# 带初始提示启动
agent "重构auth模块使用JWT认证"
# 非交互模式（适合脚本和CI/CD）
agent -p "Your prompt here"
# JSON输出格式
agent --print --output-format json "Your prompt here"
- 快捷键：
Cmd+. 快速切换模式 - UI操作：Agent界面中的模式下拉菜单
- 自定义：可在设置中配置模式切换快捷键
Composer是Cursor的代码生成引擎，支持：
- 多文件同时生成
- 智能依赖分析
- 代码一致性维护
- 上下文感知生成
## 高效提示词结构
### 1. 明确任务目标
"创建一个用户认证模块，包含登录、注册、JWT token验证"
### 2. 指定技术栈
"使用TypeScript，遵循项目现有的代码风格"
### 3. 说明约束条件
"不引入新的第三方依赖，使用现有的express框架"
### 4. 分步骤执行
"第一步：设计数据库模型
第二步：创建路由
第三步：实现中间件"
| 策略 | 说明 | 使用建议 |
|---|
| 增量生成 | 在现有代码基础上添加 | 小改动、新功能扩展 |
| 全量生成 | 创建完整的代码文件 | 新模块、复杂功能 |
| 重构生成 | 重写现有代码 | 性能优化、架构升级 |
| 功能 | Mac | Windows | 说明 |
|---|
| Agent面板 | Cmd+I | Ctrl+I | 打开AI助手 |
| Composer | Cmd+L | Ctrl+L | 代码生成 |
| Chat | Cmd+J | Ctrl+J | 对话问答 |
| Terminal | Cmd+` | Ctrl+` | 终端面板 |
| 命令面板 | Cmd+Shift+P | Ctrl+Shift+P | VS Code命令 |
| 文件搜索 | Cmd+P | Ctrl+P | 快速打开文件 |
通过Cmd+Shift+J打开Cursor设置，进入Keyboard Shortcuts进行配置：
{
"key": "cmd+m",
"command": "cursor.generateGitCommitMessage",
"description": "生成Git提交信息"
}
在Keyboard Shortcuts设置中搜索Accept Cursor Tab Suggestions，可自定义接受和拒绝建议的按键。
Context是Cursor理解项目背景的关键，提供AI代码生成所需的上下文信息。
| 类型 | 描述 | 添加方式 |
|---|
| 代码库 | 当前项目的所有代码 | 自动索引 |
| 选定代码 | 当前选中的代码片段 | 手动选择 |
| 文件 | 整个文件内容 | 拖拽或添加 |
| URL | 网页内容 | 粘贴链接 |
| 文档 | 项目文档、API文档 | 文件添加 |
| Git Diff | 代码变更对比 | 自动读取 |
## 有效提供Context的方法
### ✅ 推荐做法
- 提供清晰的代码文件
- 添加相关依赖的文档链接
- 说明代码的业务背景
- 展示期望的代码风格
### ❌ 避免做法
- 提供过多无关代码
- 缺少必要的上下文说明
- 混合不相关的功能需求
{
"version": 1,
"editor": { "vimMode": false },
"permissions": {
"allow": ["Shell(ls)", "Shell(echo)", "Read(src/**/*.ts)"],
"deny": ["Shell(rm)", "Read(.env*)"]
}
}
MCP是Cursor的扩展协议，允许AI访问外部工具和数据源。
| 功能 | 描述 |
|---|
| 工具调用 | 执行外部工具操作 |
| 数据访问 | 连接外部数据源 |
| API集成 | 调用第三方API |
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_TOKEN": "your-token" }
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
}
}
}
Skills是Cursor的自定义技能扩展，用于扩展AI能力。
~/.cursor/skills/
├── skills/
│ ├── my-custom-skill/
│ │ ├── skill.json
│ │ ├── prompts.py
│ │ └── actions.py
│ └── another-skill/
└── config.json
{
"name": "database-schema-generator",
"version": "1.0.0",
"description": "根据需求生成数据库Schema",
"commands": [
{
"name": "generate-schema",
"description": "生成数据库表结构"
}
]
}
Rules是Cursor的行为规范配置，控制AI代码生成的行为、风格和限制。
- 全局配置：
~/.cursor/rules/ - 项目配置：项目根目录
.cursor/rules/ - 文件级别：
.cursor/rules/filename.md
---
name: vue-style-guide
description: Vue 3 组件开发规范
scope: src/**/*.vue
---
# Vue 3 组件开发规范
## 代码风格
- 使用 `<script setup>` 语法
- 组件名使用 PascalCase
- Props 定义使用 TypeScript 接口
## 命名规范
- 组件文件：PascalCase
- 组件变量：camelCase
- 常量：UPPER_SNAKE_CASE
## 最佳实践
- 优先使用组合式API
- Props 应该始终被验证
- 事件使用 emits 选项定义
| 位置 | 优先级 | 说明 |
|---|
| 文件级别 | 最高 | 只对单个文件生效 |
| 项目级别 | 中 | 对整个项目生效 |
| 全局级别 | 最低 | 默认行为 |
# 设置API密钥
export CURSOR_API_KEY="your-api-key"
# Analytics API 示例
curl -X GET "https://api.cursor.com/analytics/team/dau" \
-H "Authorization: Bearer YOUR_API_KEY"
# 大团队（超过100用户）使用分页防止超时
curl -X GET "https://api.cursor.com/analytics/users" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "page=1&per_page=100"
# 初始请求
curl -X GET "https://api.cursor.com/analytics/team/dau" \
-H "Authorization: Bearer YOUR_API_KEY" \
-D headers.txt
# 响应包含: ETag: "abc123xyz"
# 后续请求使用缓存
curl -X GET "https://api.cursor.com/analytics/team/dau" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "If-None-Match: \"abc123xyz\""
| 优化点 | 说明 |
|---|
| 合理日期范围 | 1-3个月为最佳 |
| 用户过滤 | 使用users参数减少查询 |
| ETag缓存 | 减少不必要的数据传输 |
| 批量请求 | 合并多个API调用 |
# ~/.zshrc — 当Cursor Agent运行时禁用Powerlevel10k主题
if [[ -n "$CURSOR_AGENT" ]]; then
# 跳过主题初始化以获得更好兼容性
else
[[ -r ~/.p10k.zsh ]] && source ~/.p10k.zsh
fi
{
"permissions": {
"allow": [
"Shell(ls)",
"Shell(git)",
"Shell(npm run *)",
"Read(src/**/*.ts)",
"Write(package.json)"
],
"deny": [
"Shell(rm -rf *)",
"Read(.env*)",
"Write(**/*.key)"
]
}
}
- 打开Cursor设置 (
Cmd+Shift+J) - 进入
General > Account - 在"VS Code Import"下点击Import按钮
| 项目 | 说明 |
|---|
| 设置 | 编辑器配置、主题 |
| 扩展 | 已安装的插件 |
| 快捷键 | 键盘映射 |
| 代码片段 | Snippets |
# 在Cursor中打开VS Code项目目录
cd /path/to/vscode/project
cursor .
## 结构化提示词模板
### 任务描述
[简要说明要做什么]
### 上下文
[提供相关的代码和文档]
### 要求
1. [具体要求1]
2. [具体要求2]
3. [具体要求3]
### 约束
- [限制条件1]
- [限制条件2]
### 期望输出
[描述期望的代码风格和结构]
| 场景 | 推荐模式 | 原因 |
|---|
| 理解代码逻辑 | Chat | 交互式问答 |
| 新功能开发 | Composer | 代码生成 |
| 复杂重构 | Agent | 自主决策 |
| Bug修复 | Agent + Chat | 分析+修复 |
## 提升响应速度
### 1. 精简Context
- 只添加相关文件
- 避免过大的文件
- 使用文件摘要而非全文
### 2. 明确任务范围
- 分解复杂任务为小步骤
- 避免模糊的指令
- 提供具体示例
### 3. 利用Rules
- 定义项目代码规范
- 配置常用代码模式
- 减少重复说明
| 问题 | 解决方案 |
|---|
| AI回答不准确 | 提供更多上下文 |
| 生成代码有误 | 指定代码风格Rules |
| 响应速度慢 | 精简Context范围 |
| 格式错误 | 使用代码块标记 |
配置快捷键生成Git提交信息：
{
"key": "cmd+m",
"command": "cursor.generateGitCommitMessage"
}
- 使用Agent分析代码变更
- 生成审查报告
- 建议改进方案
# 管道输入
echo "修复登录bug" | agent -p --print
# 脚本集成
#!/bin/bash
agent -p "在第$LINE行添加日志" --print
| 格式 | 用途 |
|---|
text | 可读文本（默认） |
json | 程序处理 |
stream-json | 流式JSON |
agent --print --output-format json "Your prompt"
| 配置项 | 共享方式 |
|---|
| Rules | 提交到代码仓库 |
| Settings | Settings Sync |
| 快捷键 | 导出JSON分享 |
## 团队Cursor配置建议
### 1. 统一代码规范
- 创建项目级Rules
- 定义代码风格指南
- 配置导入规则
### 2. 共享快捷键
- 统一常用操作快捷键
- 避免冲突
- 文档化自定义快捷键
### 3. Agent模式规范
- 定义使用场景
- 明确审批流程
- 代码审查标准
入门 → 进阶 → 专家
↓ ↓ ↓
基础 Agent 团队
用法 Rules 规模化
配置 MCP 定制化
- Agent模式：根据任务复杂度选择合适的模式
- Context管理：精准提供上下文信息
- Rules配置：定义项目代码规范
- 快捷键优化：提升工作效率
- 团队协作：标准化配置共享
- 持续学习：关注官方文档更新
最后更新：2026年2月
参考文档：cursor.com/docs
