Cursor新手配置指南：从安装到WSL开发环境搭建

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」（隐私模式）。

代码安全优先，选择 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 支持，需要手动安装：

1. 点击左侧活动栏的扩展图标（或按 Ctrl + Shift + X）
2. 搜索 WSL
3. 找到 Remote - WSL（开发者是 Microsoft）
4. 点击 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 操作即可。

四、常见问题速查

五、快速上手快捷键

六、总结

配置 Cursor 的关键要点其实就这几步：

1. 首次启动：Skip Pro 套餐 → 选 Privacy Mode → 连接 GitHub
2. 命令行：安装 cursor 命令
3. VS Code 迁移：选 import 完整迁移
4. WSL 开发：安装 Remote - WSL 扩展，通过左下角连接
5. 多编辑器：文件自动同步，放心使用

配置完成后，就可以愉快地开启 AI 辅助编程之旅了！