下面是常见问题及其解决方案。

​
网络问题

先检查网络连接。前往 Cursor Settings > Network 并点击 Run Diagnostics。这会测试到 Cursor 服务器的连通性，帮助识别可能影响 AI 功能、更新或其他在线功能的网络问题。 Cursor 的 AI 功能依赖 HTTP/2，因为它能高效处理流式响应。如果网络不支持 HTTP/2，可能会遇到索引失败和 AI 功能异常。 这在企业网络、VPN 或使用 Zscaler 等代理时很常见。 要解决此问题，请在应用设置中启用 HTTP/1.1 回退（不是 Cursor 设置）：按 CMD/CTRL + ,，搜索 HTTP/2，然后启用 Disable HTTP/2。这会强制使用 HTTP/1.1 并解决问题。 我们计划加入自动检测和回退。

​
资源问题（CPU、RAM 等）

高 CPU 或 RAM 使用率可能会拖慢机器或触发资源警告。 大型代码库会需要更多资源，但高占用通常源自扩展或设置问题。
如果在 macOS 上看到低内存警告，请注意有个 bug 会让部分用户看到极其不准确的数值。如果遇到这种情况，请打开活动监视器并查看“内存”标签以获取正确的内存使用情况。
如果遇到高 CPU 或 RAM 使用率，试试这些步骤：
扩展会影响性能。Extension Monitor 会显示所有已安装和内置扩展的资源消耗。在 Settings > Application > Experimental 中启用扩展监视器，切换 Extension Monitor: Enabled。这会提示你重启 Cursor。打开方式：Cmd/Ctrl + Shift + P → Developer: Open Extension Monitor。Cursor 会在一个或多个 extension host 中运行扩展。通常，大多数扩展会运行在同一个 extension host 中，这意味着某个扩展占用大量 CPU 时间会“卡住”旁边的扩展！Extension Monitor 会显示：
  • 每个由扩展启动的长生命周期进程（仅限 macOS 和 Linux）。
  • % Ext Host：该扩展消耗的扩展宿主总时间百分比。用于识别相对其他扩展占用时间最多的扩展。
  • Max Blocking：每个监控区间内该扩展最长的连续阻塞执行时长。
  • % CPU：
    • 对于扩展：归因于该扩展代码的 CPU 使用百分比。
    • 对于进程：归因于该进程的 CPU 使用百分比（仅限 macOS 和 Linux）。
  • Memory：
    • 对于扩展：该扩展代码占用的 JS 堆内存（不含外部分配）。
    • 对于进程：该进程占用的系统内存（仅限 macOS 和 Linux）。
你也可以在命令行运行 cursor --disable-extensions 进行测试。如果性能改善，逐个重新启用扩展以定位问题扩展。试试 Extension Bisect 来定位问题扩展。更多说明见这里。注意：这对立即出现的问题最有效，不适合逐渐性的性能下降。
Process Explorer 会显示哪些进程在消耗资源。打开方式：命令面板（Cmd/Ctrl + Shift + P）→ Developer: Open Process Explorer。重点查看：
  • extensionHost：扩展相关问题
  • ptyHost：终端资源消耗
Process Explorer 会显示每个终端及其正在运行的命令，便于诊断。对于其他高占用进程，请到论坛反馈。
使用操作系统自带的监控工具判断问题是 Cursor 特有还是系统范围的。
如果问题仍然存在，尝试一个最小化的 Cursor 安装进行测试。

​
常见问题

新版本采用分阶段灰度发布——会先随机向部分用户推送。一般几天内就会轮到你。
在命令面板 Ctrl/⌘ + Shift + P 中使用 Sign Out of GitHub。
目前还不支持 GitHub Codespaces。
暂不支持连接到 Mac 或 Windows 机器的 SSH。其他问题请携带日志到论坛反馈。
如果你看到 “SSH is only supported in Microsoft versions of VS Code”：
  1. 卸载 Remote-SSH：
    • 打开扩展视图（Ctrl + Shift + X）
    • 搜索 “Remote-SSH”
    • 点击齿轮图标 → “Uninstall”
  2. 安装 Anysphere Remote SSH：
    • 打开 Cursor marketplace
    • 搜索 “SSH”
    • 安装 Anysphere Remote SSH 扩展
  3. 安装完成后：
    • 关闭所有存在活跃 SSH 连接的 VS Code 实例
    • 重启 Cursor
    • 通过 SSH 重新连接
确认你的 SSH 配置和密钥已正确设置。
Cursor Tab 和 Inline Edit 使用 HTTP/2 以降低延迟和资源占用。部分公司代理（例如 Zscaler）会阻止 HTTP/2。可在设置中将 "cursor.general.disableHttp2": true 设为开启（Cmd/Ctrl + ,，搜索 http2）进行修复。
在 Cursor 设置里先登出，再重新登录。
Pro 订阅者：在仪表板点击 Manage Subscription 查看续订日期。免费用户：查看你收到的第一封 Cursor 邮件的日期。使用额度会从该日期起每月重置。
磁盘空间不足可能导致 Cursor 在更新时清理历史数据。为避免这种情况：
  1. 更新前确保有足够的可用磁盘空间
  2. 定期清理不必要的系统文件
  3. 更新前备份重要对话
按照此指南操作。将其中的 “VS Code” 或 “Code” 替换为 “Cursor”，并将 “.vscode” 替换为 “.cursor”。
在仪表板点击 Delete Account。这会永久删除你的账户及所有相关数据。
在终端运行 cursor。如果没有该命令：
  1. 打开命令面板 ⌘⇧P
  2. 输入 install command
  3. 选择 Install 'cursor' command（也可选择安装 code 命令以覆盖 VS Code）
如果点击 Sign In 跳转到 cursor.com 但没有完成登录，先禁用你的防火墙或杀毒软件——它们可能拦截了登录流程。
由于近期系统被滥用的情况增多，你的请求可能被安全措施拦截。解决方法如下：先检查你的 VPN。如果在使用，尝试关闭，VPN 有时会触发我们的安全系统。如果仍未解决，可以尝试：
  • 新建一个聊天
  • 等一会儿再试
  • 使用 Google 或 GitHub 认证创建新账户
  • 升级到 Cursor Pro