​
网络问题

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

网络问题的常见症状包括：

  • 代码库索引失败并出现错误
  • Agent 显示连接错误
  • Tab 键自动完成不起作用
  • 聊天或其他 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 Tab 请求（仅限 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：用于光标选项卡请求，具体取决于您的位置（仅限 HTTP/2）
  • marketplace.cursorapi.com,cursor-cdn.com：用于从扩展市场下载扩展
  • download.todesktop.com：用于检查和下载更新

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

​
资源使用问题

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

  1. 检查已启用的扩展

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

  2. 使用 Process Explorer

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

  3. 监控系统资源

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

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

    • 在禁用扩展的情况下启动光标
    • 如果性能提高，请逐渐重新启用扩展
    • 这有助于确定哪些扩展可能会导致问题

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

​
其他

​
我在更改日志上看到更新，但 Cursor 不会更新。

如果更新非常新，则可能尚未向您推出。我们进行分阶段推出，这意味着我们先向一些随机选择的用户发布新更新，然后再将其发布给所有人。预计几天后即可获得更新！

​
我在 Cursor 中登录 GitHub 时遇到问题 / 如何在 Cursor 中注销 GitHub？

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

​
我无法使用 GitHub Codespaces。

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

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

目前，我们不支持通过 SSH 连接到 Mac 或 Windows 计算机。如果您未使用 Mac 或 Windows 计算机，请在论坛中向我们报告您的问题。包含一些日志以获得更好的帮助会很有帮助。

​
Windows 上的 SSH 连接问题

如果您遇到错误“SSH 仅在 Microsoft 版本的 VS Code 中受支持”，请执行以下步骤：

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

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

  2. 安装 Remote-SSH 版本 0.113：

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

  3. 安装后：

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

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

​
Cursor Tab 和 Cmd K 在我的公司代理后面不起作用。

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

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

尝试从 Cursor Settings （光标设置） 注销并重新登录

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

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

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

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

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

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

​
如何卸载 Cursor？

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

​
如何删除我的帐户？

您可以通过单击Delete Account按钮。请注意，这将删除您的帐户以及与之关联的所有数据。

​
如何从命令行打开 Cursor？

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

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

​
无法登录到光标

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

抢先体验计划故障排除指南