Cursor 新手配置完全指南：从安装到 WSL 开发环境搭建
最近开始体验 Cursor 这款 AI 编程助手，从安装到配置 WSL 开发环境，确实遇到了不少坑。现将整个流程整理成一份实用指南，希望能帮助正在摸索的朋友少走弯路。
一、安装与首次启动
1.1 下载安装
直接访问 Cursor 官网，下载对应操作系统的安装包，按指引正常安装即可，整个过程没有特殊门槛。
1.2 首次启动遇到的关键选择
① Pro 套餐提示
启动后，屏幕会弹出「Start your Pro plan to continue」的提示。不必担心，直接点击角落的「Skip」跳过，免费版即可正常使用。免费版已包含一定额度的 AI 代码补全和聊天功能，对绝大多数开发者来说完全够用。
② 数据共享设置
接下来会看到「Help improve Cursor for everyone」的选项。此处强烈建议直接选择「Privacy Mode」（隐私模式）。
| 选项 | 说明 |
|---|---|
| Share Data | 允许收集代码数据用于模型训练 |
| Privacy Mode | 零数据保留，代码不会被用于训练 |
代码安全优先，选择 Privacy Mode 始终是最稳妥的。即使日后想调整，随时可以在设置中切换。
③ GitHub 连接
紧接着会要求「Connect GitHub to finish setup」。点击连接，在浏览器中完成 GitHub 授权即可。
这里容易遇到一个问题：如果授权页面打开时间过久，或者不小心关闭，可能会出现「Your session expired」的提示。解决办法很简单，重新点击连接按钮，快速完成授权即可。
④ 命令行命令安装
当看到「Want to launch Cursor from the command line?」时，果断选择「install cursor」。这样以后在终端中输入 cursor . 就能直接打开当前目录，对 WSL 用户来说尤其方便。
⑤ VS Code 设置迁移
最后一步是「Bring your VS Code setup to Cursor」。这里推荐选择「import」（而不是「import without extensions」）。这样会自动导入 VS Code 的所有设置和扩展，开发环境得以保持一致，省去大量重复配置的麻烦。
二、WSL 开发环境配置
如果项目放在 WSL 中开发，就需要额外做一些配置。
2.1 安装 WSL 扩展
Cursor 默认没有 WSL 支持，需要手动安装：
- 点击左侧活动栏的扩展图标（或按
Ctrl + Shift + X） - 搜索 WSL
- 找到 Remote - WSL（开发者是 Microsoft）
- 点击 Install 安装
2.2 连接 WSL
安装完成后，通过以下方式连接：
方法一（推荐）：点击左下角的 >< 图标，选择「Connect to WSL」。
方法二：打开命令面板，输入 WSL，选择连接命令。
连接成功后，左下角会显示 WSL: Ubuntu（或您使用的发行版名称）。
2.3 打开项目
连接后，通过 File → Open Folder，浏览 WSL 中的项目目录即可。
三、多编辑器协同工作
如果同时使用 VS Code 和 Cursor 修改同一个 WSL 项目，文件会自动同步。
3.1 同步原理
两个编辑器通过 WSL 扩展访问的都是 WSL 中同一份物理文件。因此：
- 在 VS Code 里修改并保存，文件会直接更新到磁盘。
- Cursor 会自动检测到变化，并提示「文件已在外部更改，是否重新加载？」
3.2 注意事项
- 保存后再切换：避免未保存的修改被覆盖。
- 可以开启自动保存（可选）：
File→Auto Sa ve。 - Git 操作建议统一：用一个编辑器执行 Git 操作即可。
四、常见问题速查
| 问题 | 解决方案 |
|---|---|
| 找不到 WSL 命令 | 先安装 Remote - WSL 扩展 |
| GitHub 授权 session expired | 重新点击连接，快速完成授权 |
| 导入设置后不喜欢 | 命令面板执行「Import VS Code Settings」重新选择 |
| MarsCode 弹窗要求登录 | 无需理会，或禁用该插件 |
五、快速上手快捷键
| 功能 | Mac | Windows/Linux |
|---|---|---|
| AI 内联编辑 | Cmd + K | Ctrl + K |
| AI 聊天 | Cmd + L | Ctrl + L |
| 接受补全 | Tab | Tab |
| 命令面板 | Cmd + Shift + P | Ctrl + Shift + P |
| 扩展面板 | Cmd + Shift + X | Ctrl + Shift + X |
六、总结
配置 Cursor 的关键要点其实就这几步：
- 首次启动：Skip Pro 套餐 → 选 Privacy Mode → 连接 GitHub
- 命令行：安装
cursor命令 - VS Code 迁移：选
import完整迁移 - WSL 开发：安装 Remote - WSL 扩展，通过左下角连接
- 多编辑器：文件自动同步，放心使用
配置完成后，就可以愉快地开启 AI 辅助编程之旅了！
