AI 编程工具 Cursor 使用随笔

Cursor 官方使用指南

免费使用 Cursor 的方式

Cursor 实现远程开发的方式

Cursor IDE 本身是基于 VS Code 构建的(深度魔改),因此它的远程开发能力基本继承了 VS Code 的体系,实现方式也非常类似。

提示

Cursor 的远程开发 = VS Code 远程开发能力 + AI 深度介入远程代码。

通过 SSH 实现远程开发

在 Cursor IDE 中,安装远程插件,通过 SSH 连接远程服务器(比如 Linux 系统),这是最推荐、也是最接近生产环境的一种远程开发方式。

  • (1) 在 Cursor IDE 中安装 VS Code 的远程插件:

    • Remote - SSH
  • (2) 在本地配置 SSH:

    • 编辑本地的 SSH 配置文件:
      1
      vi ~/.ssh/config
    • SSH 配置文件的示例内容:
      1
      2
      3
      4
      Host Dev-Server
      HostName 192.168.1.100
      User root
      IdentityFile ~/.ssh/id_rsa # 可选
  • (3) 在 Cursor 中执行 SSH 连接:

    • 按下快捷键:Ctrl + Shift + P
    • 输入:Remote-SSH: Connect to Host
    • 选择 Dev-Server
    • 输入:SSH 连接密码(如果没有配置 SSH 免秘钥登录)
  • (4) 远程开发效果:

    • 代码实际在远程服务器运行
    • 本地只是 Cursor UI + AI 辅助
    • 支持:
      • 远程调试
      • 远程终端
      • Git 操作
      • AI 自动改代码

通过 Docker 实现远程开发

在 Cursor IDE 中,安装容器开发插件,然后在本地容器内进行开发。

  • (1) 在 Cursor IDE 中安装 VS Code 的容器开发插件:

    • 搜索插件 ID:anysphere.remote-containers
    • 注意:不是安装 VS Code 官方的容器开发插件:Dev Containers
  • (2) 在项目中添加配置文件:

    • 创建配置文件:

      1
      touch .devcontainer/devcontainer.json
    • 添加配置文件内容:

      1
      2
      3
      4
      5
      6
      {
      "name": "Dev Container",
      "image": "debian:12",
      "features": {},
      "postCreateCommand": "apt update"
      }
    • 或者(适合 C/C++ 开发):

      1
      2
      3
      4
      5
      6
      {
      "name": "Dev Container",
      "image": "debian:12",
      "features": {},
      "postCreateCommand": "apt update && apt install -y build-essential gdb cmake git"
      }
  • (3) 启动容器:

    • 按下快捷键:Ctrl + Shift + P
    • 输入:Dev Containers: Reopen in Container
  • (4) 远程开发效果:

    • 重启整个开发环境到 Docker 容器里
    • 挂载(共享)同一份代码到 Docker 容器里
    • Cursor UI 还是运行本地,但代码运行在 Docker 容器里
    • 相当于让 Cursor 将项目搬进 Docker 容器里运行,并用容器当开发环境
  • (5) 使用优势

    • 不污染本机环境
    • 可复现(非常重要)
    • 一键重建环境(非常关键)
    • 环境完全一致(开发 = 生产)
    • 团队统一开发环境(团队协作神器)

特别说明

由于此方案的容器运行在本地,因此必须在本地先安装 Docker,然后才能执行上述远程开发的配置步骤。

远程开发的使用注意事项

  • SSH 连接慢

    • 使用内网 IP
    • 开启 ControlMaster
  • 权限问题

    • 注意文件权限
    • 不要用 root 跑所有服务
  • 远程插件不生效

    • 插件需要安装在 Remote(远程)环境

Cusror 账号切换多个账号

IDEA 切换 Cusror 账号

  • (1) 关闭 IntelliJ IDEA 和 Cursor IDE(如果已安装),确保所有 Cursor 相关进程已完全结束。
  • (2) 清理以下本地缓存与认证文件:
    • %APPDATA%\Cursor\auth.json —— 核心文件,包含 accessTokenrefreshToken
    • %USERPROFILE%\.cursor\cli-config.json
    • %USERPROFILE%\.cursor\statsig-cache.json
    • %LOCALAPPDATA%\JetBrains\IntelliJIdea2026.1\jcef_cache —— IDEA 浏览器缓存
  • (3) 重新启动 IntelliJ IDEA。
  • (4) 通过右侧边栏的 AI Chat 面板,或者点击顶部菜单 View → Tool Windows → AI Chat 打开 AI Chat 面板。
  • (5) 在 AI Chat 面板中,将 AI Agent 切换为 Cursor
  • (6) 在聊天窗口中发送任意提示词,界面会显示 Cursor Login 按钮,点击该按钮开始登录。
  • (7) 点击后自动跳转到浏览器,输入你的 Cursor 账号信息完成登录。
  • (8) 浏览器授权成功后,回到 IDEA 的 AI Chat 窗口,确认 Cursor 已切换至新账号并恢复正常使用。

特别注意

  • 如果安装了 Cursor 的智能体软件,建议先退出登录,再执行上述操作。
  • 如果上述操作还是不能切换 Cursor 账号,说明 Cursor 的服务端已经记住了你的电脑设备。这种情况下,你需要在浏览器中登录 Cursor 官网,然后在账号设置中撤销相关设备的授权。