Cursor 2026 完全配置指南：从零搭建 AI 编程环境

为什么选 Cursor？

Cursor 是基于 VS Code 深度改造的 AI-first 代码编辑器。和「装个 Copilot 插件」不同，Cursor 从底层重构了编辑器和 AI 的交互方式：

Cmd+K 内联编辑：选中代码直接用自然语言描述修改意图，AI 生成 diff 你确认应用
Cmd+L 对话面板：基于整个代码库上下文的对话，能引用多个文件
Agent 模式：AI 自主规划、执行多步任务——创建文件、运行命令、修 bug，你只需审核
MCP 协议支持：连接外部工具（数据库、API、文件系统），让 AI 突破编辑器边界

2026 年的 Cursor 已经不是「辅助补全」工具，而是一个能独立完成复杂开发任务的 AI 队友。

第一步：安装 Cursor

下载安装

访问 cursor.com，点击 Download
支持 Windows / macOS / Linux 三平台
安装后首次启动，选择「Import VS Code Settings」一键迁移你的 VS Code 配置（主题、插件、快捷键全保留）

登录与订阅

Cursor 提供免费额度（每月 2000 次补全 + 50 次高级请求），够轻度使用。重度用户推荐：

方案	价格	适合谁
Free	0	体验/轻度使用
Pro	$20/月	全职开发者，每月 500 次高级请求
Business	$40/月/人	团队使用，集中管理

💡 省钱技巧：Pro 方案的 500 次高级请求指的是 GPT-4/Claude 级别模型。如果用 cursor-small 或 claude-3-haiku 等轻量模型，不消耗高级请求额度。日常补全和小修改用轻量模型，复杂架构问题再切高级模型。

第二步：核心设置优化

打开 Settings（Cmd+, / Ctrl+,），搜索以下关键配置：

2.1 代码补全设置

Settings > Features > Code Completion

配置项	推荐值	说明
Enable Tab completion	✅	核心功能，必须开
Completions model	`claude-3.5-sonnet`（Pro）或 `cursor-small`（Free）	平衡质量和速度
Temperature	0.2	低温度 = 更确定性的输出，写代码不需要「创意」
Debouncer delay	300ms	停止打字后 300ms 触发补全，太快会浪费请求
Show ghost text	✅	灰色预览补全内容，Tab 接受

2.2 AI 对话设置

Settings > Features > Chat

配置项	推荐值	说明
Default model	`claude-3.5-sonnet` 或 `gpt-4o`	综合能力最强
Include open tabs as context	✅	让 AI 看到你正在编辑的文件
Auto-attach context	✅	自动检测相关文件和符号

2.3 Agent 模式设置

Settings > Features > Agent

配置项	推荐值	说明
Enable Agent mode	✅	核心功能
Auto-run terminal commands	关闭（初期）	初期建议手动确认每条命令，熟悉后再开
Max iterations	25	Agent 单次任务最多执行步数

第三步：项目规则文件 .cursorrules

.cursorrules 是 Cursor 独有的功能——在项目根目录放一个文本文件，告诉 AI 你的项目约定。每次对话时 Cursor 自动读取并遵循。

3.1 基础模板

在项目根目录创建 .cursorrules：

# 项目概述
这是一个 Next.js 14 + TypeScript + Tailwind CSS 的 SaaS 项目。
数据库使用 PostgreSQL + Prisma ORM。

# 代码风格
- 使用函数式组件 + React Hooks，不使用 class 组件
- 所有函数参数和返回值都要有 TypeScript 类型标注
- 使用 Tailwind CSS 写样式，不使用 CSS Modules
- 组件文件用 PascalCase，工具函数用 camelCase

# 目录结构
src/
├── app/          # Next.js App Router 页面
├── components/   # React 组件
├── lib/          # 工具函数和配置
├── prisma/       # 数据库 Schema 和迁移
└── types/        # TypeScript 类型定义

# 编码约定
- 错误处理：API 路由统一用 try/catch + NextResponse.json({ error }, { status })
- 数据获取：Server Components 用 async/await，Client Components 用 SWR
- 环境变量：所有 env 变量在 env.mjs 中用 zod 校验

# 禁止事项
- 不要使用 any 类型
- 不要使用 console.log（用项目内置的 logger）
- 不要在组件内直接调用数据库，通过 lib 层封装

3.2 进阶：分目录规则

大项目可以为不同目录设置独立规则：

.cursorrules              # 全局规则
.cursor/rules/frontend.md  # 前端组件规则
.cursor/rules/backend.md   # API 路由规则
.cursor/rules/testing.md   # 测试文件规则

Cursor 会根据当前编辑的文件路径自动匹配对应规则文件。

第四步：MCP 配置 — 让 AI 连接外部世界

MCP（Model Context Protocol）是 2025 年底发布的开放协议，让 AI 能调用外部工具。Cursor 原生支持 MCP。

4.1 什么是 MCP？

简单理解：MCP 就是 AI 的「USB 接口」。通过 MCP，你的 AI 编辑器可以：

直接查询数据库（不用复制数据到对话里）
调用 API（发请求、读响应）
操作文件系统（超出项目目录的范围）
连接第三方服务（Jira、GitHub、Slack 等）

4.2 配置 MCP Server

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/your.db"],
      "env": {}
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    }
  }
}

4.3 常用 MCP Server 推荐

MCP Server	用途	安装命令
SQLite	直接查询本地 SQLite 数据库	`npx @modelcontextprotocol/server-sqlite <db路径>`
PostgreSQL	查询 PostgreSQL 数据库	`npx @modelcontextprotocol/server-postgres`
GitHub	搜索仓库、读 Issue、创建 PR	`npx @modelcontextprotocol/server-github`
Filesystem	读写指定目录的文件	`npx @modelcontextprotocol/server-filesystem`
Brave Search	AI 直接搜索互联网	`npx @modelcontextprotocol/server-brave-search`
Puppeteer	控制浏览器、截图、爬取页面	`npx @modelcontextprotocol/server-puppeteer`

4.4 在对话中使用 MCP

配置完成后，在 Cursor 对话中可以直接说：

「查询 users 表中最近 7 天注册的用户」→ AI 自动调用 SQLite MCP 执行查询
「搜索 GitHub 上 star 最多的 Rust web 框架」→ AI 调用 GitHub MCP
「打开 localhost:3000 截个图看看效果」→ AI 调用 Puppeteer MCP

第五步：高效工作流

5.1 Cmd+K — 快速内联编辑

选中一段代码，按 Cmd+K，用自然语言描述修改：

选中: function calculateTotal(items) { ... }
输入: 添加折扣计算逻辑，满 100 打 9 折，VIP 用户额外 95 折

Cursor 会生成 diff 预览，你确认或拒绝。比手写快 5-10 倍。

5.2 Cmd+L — 代码库对话

按 Cmd+L 打开对话面板，可以：

@file 引用特定文件
@folder 引用整个目录
@code 搜索并引用代码符号（函数名、类名）
@web 搜索互联网（需要联网）
@docs 引用指定文档（需要先添加文档）

最佳实践：问复杂问题时，先 @ 相关文件再提问，AI 的回答质量会显著提升。

5.3 Agent 模式 — 自主完成多步任务

在 Cmd+K 或 Cmd+L 中切换到 Agent 模式：

输入: 帮我创建一个用户注册功能，包括：
1. Prisma Schema 添加 User 模型
2. API 路由 POST /api/auth/register
3. 前端注册表单组件
4. 输入校验和错误处理

Agent 会自动：

修改 prisma/schema.prisma 添加 User 模型
运行 npx prisma migrate dev 执行迁移
创建 src/app/api/auth/register/route.ts
创建 src/components/RegisterForm.tsx
每一步都生成 diff 供你审核

5.4 @docs — 添加官方文档

Cursor 支持导入第三方文档，让 AI 基于官方文档回答：

打开 Cmd+L 对话面板
点击 # 或输入 @docs
选择「Add new docs」
输入文档 URL（如 https://nextjs.org/docs）
Cursor 会爬取并索引文档

之后对话中 @docs Next.js 就能基于最新官方文档回答问题，不再依赖训练数据中的过时信息。

第六步：性能优化与常见问题

6.1 索引优化

Cursor 会索引项目文件以提供上下文。大项目（>1000 文件）建议：

创建 .cursorignore（语法同 .gitignore）：

node_modules/
dist/
build/
.next/
coverage/
*.min.js
*.map

6.2 网络问题

Cursor 的 AI 功能需要联网。国内用户可能遇到连接不稳定：

设置 > General > Proxy 配置代理地址
或使用系统代理（Cursor 默认读取系统代理设置）

6.3 Token 用量监控

Settings > Features > Usage 可以查看当月 API 请求用量。Pro 用户注意 500 次高级请求的消耗：

每次 Cmd+K 编辑 = 1 次请求
每次 Cmd+L 对话 = 1 次请求（多轮对话只算 1 次）
Agent 模式每个 iteration = 1 次请求

💡 省额度技巧：简单修改用 cursor-small 模型（不消耗高级额度），只有复杂架构讨论和 Agent 模式用高级模型。

常见问题排查

Q：补全速度很慢，经常超时？ A：检查网络代理设置。也可以把补全模型切换为 cursor-small，响应更快。

Q：Agent 模式经常跑偏或死循环？ A：1）把 .cursorrules 写得更具体；2）降低 Max iterations；3）复杂任务拆分成多个小任务。

Q：AI 生成的代码引用了不存在的方法/API？ A：用 @docs 添加相关框架的官方文档，让 AI 基于真实文档生成代码。

Q：.cursorrules 写了但 AI 不遵循？ A：1）检查文件是否在项目根目录；2）规则写得太长（建议 < 1000 字）；3）规则之间有矛盾。

总结

配置项	重要程度	备注
补全模型选择	⭐⭐⭐	平衡质量和额度
.cursorrules	⭐⭐⭐	项目级 AI 行为约束
MCP 配置	⭐⭐⭐	让 AI 连接数据库和外部工具
@docs 文档导入	⭐⭐	基于最新文档生成代码
.cursorignore	⭐⭐	大项目索引优化

配置好以上五项，Cursor 就从一个「代码编辑器」变成了真正理解你项目的 AI 开发伙伴。

参考来源：

为什么选 Cursor？

第一步：安装 Cursor

下载安装

登录与订阅

第二步：核心设置优化

2.1 代码补全设置

2.2 AI 对话设置

2.3 Agent 模式设置

第三步：项目规则文件 .cursorrules

3.1 基础模板

3.2 进阶：分目录规则

第四步：MCP 配置 — 让 AI 连接外部世界

4.1 什么是 MCP？

4.2 配置 MCP Server

4.3 常用 MCP Server 推荐

4.4 在对话中使用 MCP

第五步：高效工作流

5.1 Cmd+K — 快速内联编辑

5.2 Cmd+L — 代码库对话

5.3 Agent 模式 — 自主完成多步任务

5.4 @docs — 添加官方文档

第六步：性能优化与常见问题

6.1 索引优化

6.2 网络问题

6.3 Token 用量监控

常见问题排查

总结

相关内容

为什么选 Cursor？

第一步：安装 Cursor

下载安装

登录与订阅

第二步：核心设置优化

2.1 代码补全设置

2.2 AI 对话设置

2.3 Agent 模式设置

第三步：项目规则文件 .cursorrules

3.1 基础模板

3.2 进阶：分目录规则

第四步：MCP 配置 — 让 AI 连接外部世界

4.1 什么是 MCP？

4.2 配置 MCP Server

4.3 常用 MCP Server 推荐

4.4 在对话中使用 MCP

第五步：高效工作流

5.1 Cmd+K — 快速内联编辑

5.2 Cmd+L — 代码库对话

5.3 Agent 模式 — 自主完成多步任务

5.4 @docs — 添加官方文档

第六步：性能优化与常见问题

6.1 索引优化

6.2 网络问题

6.3 Token 用量监控

常见问题排查

总结

相关内容