常见问题 - 图1

Cursor 课程跳转地址 >> http://gk.link/a/12wsI

Cursor 应用常见问题故障排除指南，包括更新、登录和连接问题

网络问题

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

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

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

以下是故障排除步骤：

  1. 检查你的互联网连接
  2. 验证是否在公司代理或 VPN 后面
  3. 通过运行以下命令测试是否可以访问 HTTP/2：
  1.     curl -I --http2 -v https://api2.cursor.sh

如果你看到以下响应，表示 HTTP/2 协议没有正确协商：

  1.     * ALPN: 服务器未同意协议。使用默认协议。
  2.     * 使用 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：根据你的位置用于 Cursor Tab 请求（仅限 HTTP/2）
  • marketplace.cursorapi.com、cursor-cdn.com：用于从扩展市场下载扩展
  • download.todesktop.com：用于检查和下载更新

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

资源使用问题

如果你在使用 Cursor 时遇到 CPU 或内存使用过高的问题，以下是诊断和解决问题的步骤：

  1. 检查已启用的扩展

    • 一些扩展可能会显著影响性能
    • 逐个禁用扩展以找出问题扩展
    • 考虑移除未使用的扩展

  2. 使用进程资源管理器

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

  3. 监控系统资源

    • 检查问题是 Cursor 特有的还是系统范围的
    • 考虑关闭其他占用资源较多的应用程序
    • 确保你的系统符合最低要求

  4. 使用最小扩展进行测试

    • 禁用所有扩展启动 Cursor
    • 如果性能改善，逐步重新启用扩展
    • 这有助于识别可能导致问题的扩展

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

其他

我在更新日志中看到更新，但 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 仅支持 Microsoft 版本的 VS Code” 错误，请按照以下步骤操作：

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

    • 打开扩展视图（Ctrl + Shift + X）
    • 搜索 “Remote-SSH”
    • 点击齿轮图标并选择 “Uninstall”

  2. 安装 Remote-SSH 的 0.113 版本：

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

  3. 安装后：

    • 关闭所有有活动 SSH 连接的 VS Code 实例
    • 完全重启 Cursor
    • 再次尝试连接 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 设置中注销并重新登录。

我的使用次数何时重置？

如果你订阅了 Pro，可以点击 仪表盘 上的 “Manage Subscription” 按钮，你的计划续订日期将显示在顶部。

如果你是免费用户，可以检查你收到的第一封邮件的日期。你的使用次数会从那一天起每月重置。

我的聊天/Composer 历史记录在更新后消失了。

如果你发现聊天或 Composer 历史记录在更新后被清除，这可能是由于系统磁盘空间不足。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 时仍然看到登录按钮，尝试禁用防火墙或杀毒软件，因为它们可能阻止了登录过程。