Cursor 安装与配置

从下载登录到 Agent 改代码、Project Rules 与审 diff，一套 Cursor 安装 + 使用 + 日常开发流程。

概述

Cursor 是基于 VS Code 的 AI 原生编辑器，集成补全、行内编辑、Chat 与 Agent。本篇从安装配置讲到用 Agent 完成一次真实小改动，并说明如何用 Rules 固化项目约定。

前置条件

安装与获取

  1. 打开 cursor.com/download（或 cursor.com）下载对应平台安装包
  2. 安装并启动 Cursor
  3. Linux 也可按官方文档使用 apt / yum 仓库或 AppImage；macOS 可用 Homebrew：brew install --cask cursor

官方快速上手：Cursor Quickstart。

首次配置

  1. 导入 VS Code 设置（可选）：扩展、快捷键、主题可一键迁移
  2. 登录 Cursor 账户
  3. Models：Settings → Models，选择默认模型（按任务在 Agent 中也可临时切换）
  4. Privacy Mode（团队强烈建议）：Settings → General → Privacy，开启后按官方说明限制训练留存
  5. 打开文件夹：File → Open Folder，等待代码库索引完成

可选：在 .cursorignore 中排除 node_modules、.venv、密钥与大二进制，减少噪音与误读。

核心用法

能力 典型用途
Tab 补全 行内续写、按当前文件风格补全
行内编辑（如 Cmd/Ctrl+K） 选中代码后用自然语言改这一段
Chat 「这段逻辑做什么」「bug 可能在哪」
Agent 跨文件实现功能、跑命令、给 diff 供你审

第一次用 Agent 建议流程：

  1. 打开 Agent（文档快捷键以当前版本为准，常见为 Cmd/Ctrl+I）
  2. 用自然语言描述可验收的小目标，并用 @ 引用相关文件
  3. 需要规划时用 Plan Mode（在 Agent 输入区切换），先看计划再执行
  4. 逐项审 diff，接受或追加纠正
  5. 让 Agent 跑项目已有的 test / lint / build，你再亲自确认

Cursor 3 起也可使用 Agents Window 管理并行 Agent / worktree；日常单任务仍可用经典编辑器视图。见 Agents Window。

开发实践

推荐的项目级约定：

  1. 在 .cursor/rules/ 下按主题拆分规则（测试、API、前端），需要时用 glob 限定作用范围；旧版单文件 .cursorrules 仍可用但不如目录灵活
  2. 也可在仓库根放简洁的 AGENTS.md 描述栈与「不要做什么」
  3. 开发闭环：打开仓库 → 提小需求 → Agent 改 → 审 diff → 跑测试 → 提交
  4. 复杂任务拆成多次对话；独立子任务可用 worktree 隔离，避免并行改同一文件冲突
  5. 终端命令保持「执行前询问」类守卫，敏感操作不要一键全开

示例规则片段（示意）：

# 后端约定
- API 走 Router → Service → Model，Router 不写复杂业务
- 改动后运行项目既有 pytest；不要跳过失败测试

常见问题

延伸阅读