安装与配置

安装 Cursor 本身并不难，真正决定你第一天体验好不好的，反而是后面的配置细节。很多人软件装上没问题，但模型、迁移、规则、插件兼容这些没处理好，第一印象就会很一般。

所以这页不只是“怎么装”，而是更偏“怎么把第一天环境搭顺”。

#系统要求

#下载安装

#macOS

1. 访问 cursor.com↗
2. 点击 "Download for Mac"
3. 打开下载的 .dmg 文件
4. 将 Cursor 拖入 Applications 文件夹

bash复制
# 或使用 Homebrew 安装
brew install --cask cursor

#Windows

1. 访问 cursor.com↗
2. 点击 "Download for Windows"
3. 运行下载的安装程序
4. 按提示完成安装

#Linux

bash复制
# AppImage 方式
chmod +x cursor-*.AppImage
./cursor-*.AppImage

# 或添加到 PATH
sudo mv cursor-*.AppImage /usr/local/bin/cursor

#从 VS Code 迁移

Cursor 支持一键导入 VS Code 配置：

1. 首次启动 Cursor
2. 选择 "Import VS Code Settings"
3. 等待导入完成

导入的内容包括：

• 插件/扩展
• 主题和字体设置
• 快捷键配置
• 用户设置

这一步是我很建议做的。原因很简单：如果你熟悉的编辑器环境能原样带过来，你在判断 Cursor 好不好用时，就更容易把注意力放在 AI 协作本身，而不是浪费在重新适应界面上。

#账号登录

#免费账号

1. 点击左下角头像图标
2. 选择 "Sign In"
3. 使用 GitHub 或 Google 账号登录

免费额度：

• 每月 2000 次慢速请求 (GPT-4)
• 50 次快速请求
• 无限次 GPT-3.5 请求

#Pro 账号 ($20/月)

升级 Pro 可获得：

• 无限次快速请求
• 优先响应速度
• 更长的上下文窗口
• Claude 模型访问权限

#基础配置

#选择 AI 模型

打开设置 (Cmd+,)，找到 "Models" 部分：

json复制
{
  "cursor.chat.model": "gpt-4",
  "cursor.composer.model": "claude-3.5-sonnet",
  "cursor.autocomplete.model": "cursor-small"
}

推荐配置：

• Chat: gpt-4 或 claude-3.5-sonnet
• Composer: claude-3.5-sonnet (代码能力强)
• Tab 补全: cursor-small (快速响应)

如果你刚开始用，我更建议优先把“哪个入口用哪个模型”想清楚，而不是一开始就追求最强模型全覆盖。很多时候，体验差不是模型不够强，而是你把高延迟模型放在了高频动作里。

#配置 .cursorrules

在项目根目录创建 .cursorrules 文件，自定义 AI 行为：

markdown复制
# Project Rules

## Tech Stack
- React 18 with TypeScript
- Next.js 14 App Router
- Tailwind CSS
- Prisma ORM

## Code Style
- Use functional components with hooks
- Prefer named exports
- Use TypeScript strict mode
- Follow Airbnb style guide

## AI Instructions
- Always add TypeScript types
- Include error handling
- Write unit tests for new functions
- Use English comments

#常用设置

json复制
{
  // 启用 Tab 补全
  "cursor.autocomplete.enabled": true,

  // 补全延迟 (毫秒)
  "cursor.autocomplete.delay": 100,

  // 自动接受补全
  "cursor.autocomplete.autoAccept": false,

  // Chat 历史保存
  "cursor.chat.saveHistory": true
}

这些设置看起来小，但会直接影响第一周的使用感受。比如补全延迟太高，你会觉得它跟不上；自动接受太激进，你又会觉得它总在抢方向。

#常见问题

#无法登录

1. 检查网络连接
2. 尝试使用代理
3. 清除 Cursor 缓存：
   • macOS: ~/Library/Application Support/Cursor
   • Windows: %APPDATA%/Cursor

#AI 响应慢

• 检查是否用尽免费额度
• 尝试切换到较小的模型
• 考虑升级 Pro 账号

我会再补一个很常见但容易忽略的原因：上下文太重。很多人刚开始用，会把整个项目、很多文档、很多历史对话一起带着跑，结果不是模型不行，而是信息太多。

#插件不工作

某些 VS Code 插件可能与 Cursor 不完全兼容：

• 尝试更新插件版本
• 查看 Cursor 的已知问题列表
• 考虑使用替代插件

#一个更实用的建议

如果你是第一次装 Cursor，我更推荐这样完成“第一天配置”：

1. 先导入 VS Code 配置
2. 先确认 Chat、Composer、Tab 都能正常响应
3. 再补 .cursorrules
4. 最后再处理那些你平时强依赖的插件

这样你能更快区分：问题到底出在 Cursor 本身，还是出在迁移过来的环境配置。

#下一步

• 第一个项目 - 用 Cursor 创建第一个项目
• AI Chat 对话 - 学习 Chat 功能

如果你刚装好，我会建议下一步先看“第一个项目”。先把一条小闭环跑通，比继续堆设置更容易建立正确预期。