Cursor 安装与使用指南

Cursor 是目前生态最成熟的 AI 原生 IDE，基于 VS Code fork，支持 Tab 补全、对话改代码、Agent 多文件编辑与 Plan 模式。本文覆盖安装到日常实战的完整流程。

产品概览

安装步骤

1. 下载

访问 cursor.com/download，按系统自动识别下载：

macOS 可选 Homebrew：

# 通过 Homebrew 安装 Cursor（macOS）
brew install --cask cursor

Linux Debian/Ubuntu：

# 添加 Cursor 官方 apt 源并安装
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null
sudo apt update && sudo apt install cursor

2. 安装与首次启动

• macOS：打开 .dmg，拖入「应用程序」文件夹
• Windows：运行 .exe，按向导完成，可选加入 PATH
• Linux AppImage：chmod +x Cursor-*.AppImage && ./Cursor-*.AppImage

首次启动时建议：

1. Import from VS Code — 一键导入扩展、快捷键、settings.json
2. 登录账号 — GitHub / Google / 邮箱，同步设置与用量
3. 选择 AI 模型 — 在设置中配置默认模型与消费上限

3. 安装命令行工具

按 Ctrl+Shift+P（macOS：Cmd+Shift+P），搜索并执行：

Shell Command: Install 'cursor' command in PATH

之后在终端可用：

# 用 Cursor 打开当前项目目录
cursor .

4. 验证安装

1. 打开任意项目文件夹，等待右下角索引完成
2. 按 Ctrl+L 打开 Chat，输入「解释这个项目的目录结构」
3. 在代码文件中输入，观察 Tab 补全是否生效

核心功能与用法

Tab 补全（Inline Completion）

写代码时 Cursor 会预测下一行或多行，按 Tab 接受建议。

技巧：

• 先写函数签名或注释，再触发补全
• 在 settings.json 中可调整 cursor.cpp.enablePartialAccepts 等选项

Chat 对话（Ask 模式）

示例提示词：

@src/utils/api.ts
请为这个模块补充错误处理，要求：
- 使用 TypeScript 严格类型
- 每个导出函数添加 JSDoc 注释
- 不要修改对外 API 签名

Agent 模式（多文件编辑）

按 Ctrl+I / Cmd+I 打开 Agent，适合跨文件功能开发：

## 任务
为 Vue 3 项目添加用户设置页

## 要求
- Composition API + TypeScript
- 路由注册到 router/index.ts
- 样式与现有 SettingsLayout 一致

## 约束
- 函数添加 JSDoc
- 组件销毁时清理副作用

工作流： 描述任务 → Agent 生成 Plan → 审阅 diff → Accept / 迭代

Rules（项目规则）

在项目根目录创建 .cursor/rules/，用 .mdc 文件定义编码规范：

---
description: Vue 3 项目规范
globs: ["**/*.vue", "**/*.ts"]
alwaysApply: false
---

- 使用 Composition API，禁止 Options API
- 禁止 any，GIS 坐标需区分弧度与角度
- Cesium viewer 必须在 onUnmounted 中销毁

注意：不要同时使用旧版 .cursorrules 与新版 .cursor/rules/ 目录。

Plan 模式

复杂任务先让 AI 拆解步骤，确认后再执行，减少「一次改太多」的风险。

优缺点分析

优点

缺点

常见问题

与其他工具对比

延伸阅读

• 编程工具专栏总索引
• TRAE IDE 指南
• Claude Code 指南
• AI Skills 使用指南

本文由 xueyise 创作，AI 编程工具专栏。