​
网络问题

如果您在使用 Cursor 时遇到连接问题，以下是一些故障排除步骤

网络问题的常见症状包括

  • 代码库索引失败并出现错误
  • 代理显示连接错误
  • 标签页自动完成功能不工作
  • 聊天或其他 AI 功能无法响应

以下是故障排除步骤

  1. 检查您的互联网连接
  2. 验证您是否位于企业代理或 VPN 后
  3. 通过运行以下命令测试 HTTP/2 是否可访问 
    curl -I --http2 -v https://api2.cursor.sh
    如果您看到以下响应，则表示 HTTP/2 未正确协商 
    * ALPN: server did not agree on a protocol. Uses default.
* using HTTP/1.x

​
ZScaler

如果您正在使用 ZScaler 并遇到连接问题，以下是您的选项

  1. 配置 ZScaler 代理以正确支持 HTTP/2 ALPN 协商
  2. 将 cursor.sh 域加入白名单以绕过 ZScaler 检查

以下域需要可访问

  • api2.cursor.sh: 用于大多数 API 请求
  • api3.cursor.sh: 用于 Cursor 标签页请求 (仅限 HTTP/2)
  • repo42.cursor.sh: 用于代码库索引 (仅限 HTTP/2)
  • api4.cursor.sh, us-asia.gcpp.cursor.sh, us-eu.gcpp.cursor.sh, us-only.gcpp.cursor.sh: 用于 Cursor 标签页请求，取决于您的位置 (仅限 HTTP/2)
  • marketplace.cursorapi.com, cursor-cdn.com: 用于从扩展市场下载扩展
  • download.todesktop.com: 用于检查和下载更新

要验证 ZScaler 是否导致问题，请尝试暂时断开 ZScaler 的连接，并测试 Cursor 的功能是否恢复。

​
资源使用问题

如果您在使用 Cursor 时遇到 CPU 或 RAM 使用率过高的问题，以下是诊断和解决问题的步骤

  1. 检查启用的扩展

    • 某些扩展可能会显著影响性能
    • 逐个禁用扩展以识别有问题的扩展
    • 考虑移除未使用的扩展

  2. 使用进程资源管理器

    • 打开命令面板 (Cmd/Ctrl + Shift + P)
    • 输入 “Developer: Open Process Explorer”
    • 监控哪些进程正在消耗资源
    • 查找任何使用过多 CPU 或内存的进程

  3. 监控系统资源

    • 检查问题是 Cursor 特有的还是系统范围的
    • 考虑关闭其他资源密集型应用程序
    • 确保您的系统满足最低要求

  4. 使用最少的扩展进行测试

    • 在禁用扩展的情况下启动 Cursor
    • 如果性能有所提高，请逐步重新启用扩展
    • 这有助于识别哪些扩展可能导致问题

在报告资源使用问题时，进程资源管理器和系统资源监视器的屏幕截图对于诊断问题非常有帮助。

​
其他

​
我在更新日志中看到了更新，但 Cursor 无法更新。

如果更新非常新，则可能尚未向您推出。我们进行分阶段发布，这意味着我们在向所有人发布新更新之前，先向一些随机选择的用户发布新更新。预计在几天内您会收到更新！

​
我在 Cursor 中使用 GitHub 登录时遇到问题 / 如何在 Cursor 中退出 GitHub？

您可以尝试从命令面板 Ctrl/⌘ + Shift + P 中使用 Sign Out of GitHub 命令。

​
我无法使用 GitHub Codespaces。

不幸的是，我们尚不支持 GitHub Codespaces。

​
我连接到远程 SSH 时遇到错误。

目前，我们不支持 SSH 连接到 Mac 或 Windows 机器。如果您没有使用 Mac 或 Windows 机器，请在论坛中向我们报告您的问题。提供一些日志将有助于我们更好地为您提供帮助。

​
Windows 上的 SSH 连接问题

如果您遇到 “SSH is only supported in Microsoft versions of VS Code” 错误，请按照以下步骤操作

  1. 卸载当前的 Remote-SSH 扩展

    • 打开扩展视图 (Ctrl + Shift + X)
    • 搜索 “Remote-SSH”
    • 单击齿轮图标并选择 “卸载”

  2. 安装 0.113 版本的 Remote-SSH

    • 转到 Cursor 市场
    • 搜索 “Remote-SSH”
    • 找到 0.113 版本并安装它

  3. 安装后

    • 关闭所有具有活动 SSH 连接的 VS Code 实例
    • 完全重启 Cursor
    • 再次尝试通过 SSH 连接

如果仍然遇到问题，请确保您的 SSH 配置正确，并且您已正确设置必要的 SSH 密钥。

​
Cursor 标签页和 Cmd K 在我的企业代理后面无法工作。

Cursor 标签页和 Cmd K 默认使用 HTTP/2，这使我们能够以更低的延迟使用更少的资源。某些企业代理（例如某些配置中的 Zscaler）会阻止 HTTP/2。要解决此问题，您可以在设置中设置 "cursor.general.disableHttp2": true（Cmd/Ctrl + , 然后搜索 http2）。

​
我刚刚订阅了 Pro，但在应用程序中仍然是免费计划。

尝试从 Cursor 设置中注销并重新登录

​
我的用量何时再次重置？

如果您订阅了 Pro，您可以从仪表板点击 Manage Subscription，您的计划续订日期将显示在顶部。

如果您是免费用户，您可以查看您在收件箱中收到我们的第一封电子邮件的时间。您的用量将从该日期起每月重置。

​
更新后我的聊天/编辑器历史记录消失了

如果您注意到更新后您的聊天或编辑器历史记录已被清除，这可能是由于系统磁盘空间不足所致。当磁盘空间有限时，Cursor 可能需要在更新期间清除历史数据。为防止这种情况发生

  1. 在更新前确保您有足够的可用磁盘空间
  2. 定期清理系统上不必要的文件
  3. 考虑在更新前备份重要的对话

​
如何卸载 Cursor？

您可以按照本指南卸载 Cursor。将所有出现的 “VS Code” 或 “Code” 替换为 “Cursor”，并将 “.vscode” 替换为 “.cursor”。

​
如何删除我的账户？

您可以通过点击仪表板中的 Delete Account 按钮来删除您的账户。请注意，这将删除您的账户以及与之关联的所有数据。

​
如何从命令行打开 Cursor？

您可以通过在终端中运行 cursor 从命令行打开 Cursor。如果您缺少 cursor 命令，您可以

  1. 打开命令面板 ⌘⇧P
  2. 输入 install command
  3. 选择 Install 'cursor' command （以及可选的 code 命令，它将覆盖 VS Code 的 code 命令）

​
无法登录 Cursor

如果您在 Cursor 的设置选项卡的“通用”选项卡上单击“登录”，但被重定向到 cursor.com，然后返回 Cursor 后仍然看到“登录”按钮，请尝试禁用您的防火墙或防病毒软件，这可能会阻止登录过程。

此页内容对您有帮助吗？

提前体验计划故障排除指南