第 2 章

Cursor 安装与配置——那些文档没告诉你的关键设置

第2章:Cursor 安装与配置——那些文档没告诉你的关键设置

安装 Cursor 是5分钟的事,配置好它是另一回事。大多数教程止步于"下载安装、登录账号",但决定你效率的是那10个默认关闭的关键设置,以及你的第一个 .cursorrules 文件。

安装

macOS:从 cursor.com 下载 .dmg,拖到 Applications,完成。

Windows:下载 .exe 安装包,按向导完成。Cursor 基于 VS Code,熟悉 VS Code 的用户会感到完全一致。

Linux:下载 .AppImagechmod +x 后运行,或者用 .deb/.rpm 包。

首次启动会提示导入 VS Code 配置(扩展、主题、键绑定),选择导入可以零成本迁移。

模型选择:性能与成本对照

模型 适合场景 速度 成本
claude-sonnet-4-6 复杂代码生成、架构讨论、日常主力
claude-haiku-4-5 快速补全、简单问答、高频调用
GPT-4o 需要和 OpenAI 生态对比时
cursor-small 极简任务,省 token 极快 极低

建议:日常用 claude-sonnet-4-6,追求速度用 claude-haiku-4-5,复杂架构设计偶尔升级到 claude-opus。不需要每次都用最贵的模型。

Privacy Mode(隐私模式)

默认关闭。开启路径:Settings → General → Privacy Mode。

开启后:你的代码不会被用于 Anthropic/OpenAI 的模型训练。如果你的代码库包含商业机密、用户数据、或者公司有合规要求,必须开启。

Cursor Business 计划($40/月/人)会强制开启 Privacy Mode,并提供集中管理。处理敏感数据的团队应该用 Business 版,而不是个人版加手动开启。

10个关键设置

进入 Settings(Cmd/Ctrl+Shift+J):

1. Auto Import(自动导入) 路径:Editor → Auto Import 开启后,AI 生成代码时自动加入缺少的 import 语句。强烈建议开启。

2. Cursor Tab(Tab 补全) 路径:Features → Cursor Tab 开启后,Tab 键接受内联建议。这是 Cursor 最基础的功能,默认应该是开的,确认一下。

3. Context Files(上下文文件数) 路径:Features → Codebase Indexing 把 "Max files to index" 设为项目实际文件数,大型项目需要调高默认值(默认可能只索引前1000个文件)。

4. Rules for AI(全局规则) 路径:General → Rules for AI 在这里写对所有项目生效的全局规则,比如"回复用中文""代码注释用英文"。

5. Include/Exclude Files(索引范围) 在 .cursorignore 文件里控制,把 node_modules/dist/.git/ 这些目录排除,避免浪费索引空间。

6. Editor Font Size(编辑器字体) 个人偏好,但长时间写代码建议稍大(13-14px)。

7. Terminal Keybindings(终端快捷键) 确认和你现有的终端习惯一致,避免误触。

8. Vim/Emacs Mode(键位模式) 如果你是 Vim 用户,在 Settings 里开启 Vim 模式,Cursor 会完整支持。

9. Multi-cursor editing(多光标编辑) 确认 Alt+Click 和 Cmd+D 等多光标快捷键正常工作。

10. Git Integration(Git 集成) Source Control 侧边栏开启后,可以让 AI 根据 diff 生成 commit message,节省不少时间。

第一个 .cursorrules 文件

在项目根目录创建 .cursorrules,这是 AI 在这个项目里遵守的规则。一个最小有效的 .cursorrules:

# 技术栈
- 语言:TypeScript 5,strict: true
- 框架:Next.js 14 App Router
- 数据库:PostgreSQL + Prisma ORM
- 样式:Tailwind CSS

# 代码规范
- 使用函数式组件,不用 class 组件
- 状态管理用 Zustand,不用 Redux
- 所有 async 函数必须有 try/catch

# 命名规范
- 组件文件:PascalCase(UserCard.tsx)
- 工具函数:camelCase(formatDate.ts)
- 常量:UPPER_SNAKE_CASE

# 禁止事项
- 不要用 any 类型(有例外时加注释说明原因)
- 不要在组件里直接访问数据库,通过 API 层

.cursorrules 的价值:每次 AI 生成代码,它都会参考这个文件。你不需要每次 Prompt 里重复"用 TypeScript""用 Prisma",AI 已经知道了。

本章要点

  1. 模型按场景选:日常用 Sonnet,追速度用 Haiku,高精度用 Opus。
  2. Privacy Mode 是合规必须品:涉及用户数据或商业机密,必须开启。
  3. 10个设置里最重要的:Auto Import、Cursor Tab、Rules for AI、和 Codebase Indexing 文件数上限。
  4. .cursorrules 是第一天就要建的文件:它让 AI 从第一行代码开始就了解你的项目。
  5. 导入 VS Code 配置:迁移成本几乎为零,不要从头配置。
本章评分
4.6  / 5  (86 评分)

💬 留言讨论