Cursor 安装与配置——那些文档没告诉你的关键设置
第2章:Cursor 安装与配置——那些文档没告诉你的关键设置
安装 Cursor 是5分钟的事,配置好它是另一回事。大多数教程止步于"下载安装、登录账号",但决定你效率的是那10个默认关闭的关键设置,以及你的第一个 .cursorrules 文件。
安装
macOS:从 cursor.com 下载 .dmg,拖到 Applications,完成。
Windows:下载 .exe 安装包,按向导完成。Cursor 基于 VS Code,熟悉 VS Code 的用户会感到完全一致。
Linux:下载 .AppImage,chmod +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 已经知道了。
本章要点
- 模型按场景选:日常用 Sonnet,追速度用 Haiku,高精度用 Opus。
- Privacy Mode 是合规必须品:涉及用户数据或商业机密,必须开启。
- 10个设置里最重要的:Auto Import、Cursor Tab、Rules for AI、和 Codebase Indexing 文件数上限。
- .cursorrules 是第一天就要建的文件:它让 AI 从第一行代码开始就了解你的项目。
- 导入 VS Code 配置:迁移成本几乎为零,不要从头配置。