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 Save。
• Git 操作建议统一：用一个编辑器执行 Git 操作即可。

四、常见问题速查

五、快速上手快捷键

六、总结

配置 Cursor 的关键步骤可以浓缩为以下几点：

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

配置完成后，就可以顺利开始 AI 辅助编程了！????

来源：互联网