跳到主要内容

common-issues

尽管我们致力于让 Cursor 尽可能稳定，但偶尔仍可能出现问题。以下是一些常见问题及其解决方法。

（注：由于用户提供的原始文档内容较短且未包含具体问题列表，此处仅翻译现有内容。若需完整翻译，请提供完整的英文文档内容，我将严格按照上述规则进行专业翻译。）

网络问题排查指南​

第一步：网络连接诊断 前往 Cursor 设置 > 网络，点击 运行诊断 按钮。该操作将测试您与 Cursor 服务器的连接状态，帮助识别可能影响 AI 功能、软件更新或其他在线服务的网络问题。

HTTP/2 协议支持说明 Cursor 的 AI 功能高度依赖 HTTP/2 协议，因其处理流式响应的能力。若您的网络环境不支持 HTTP/2（常见于企业内网、VPN 连接或使用 Zscaler 等代理服务时），可能导致以下问题：

  • 代码索引失败
  • AI 功能无法使用

解决方案：启用 HTTP/1.1 回退机制 Cursor 现已内置 HTTP/1.1 兼容模式（速度较慢但功能可用）。启用步骤如下：

  1. 在应用设置（非 Cursor 设置）中按下 CMD/CTRL + ,
  2. 搜索栏输入 HTTP/2
  3. 启用 禁用 HTTP/2 选项

此操作将强制使用 HTTP/1.1 协议，通常可解决上述网络兼容性问题。

未来改进计划 我们正在开发自动检测与协议回退功能，后续版本将提供更智能的网络适配方案！

资源占用问题（CPU、内存等）​

部分用户在使用 Cursor 时会遇到高 CPU 或内存占用问题，这可能导致设备运行变慢或出现内存占用过高的警告提示。

虽然 Cursor 在处理大型代码库时确实需要较多资源，但对于大多数用户而言这种情况并不常见，更可能由 Cursor 的扩展或设置引发。

💡 如果在 MacOS 上看到内存不足警告，请注意某些用户会遇到显示数值严重失真的系统错误。若遇到此情况，请打开「活动监视器」并查看「Memory」Tab 以获取准确的内存使用数据。

若您在 Cursor 中遇到高 CPU 或内存占用问题，请按以下步骤进行诊断和修复：

检查扩展程序​

虽然许多扩展非常实用，但某些扩展会显著影响性能！

您可以通过命令行运行 cursor --disable-extensions 启动禁用所有扩展的 Cursor 进行测试。若性能有所改善，请逐步重新启用扩展以定位问题扩展。

您也可以尝试使用「扩展二分排查」功能，该功能可帮助识别问题扩展。更多信息请参阅此文档，但需注意此方法仅适用于即时显现的明显问题，不适用于随时间推移逐渐恶化的状况。

使用进程资源管理器​

进程资源管理器是 Cursor 内置的系统资源监控工具。

打开方式：调出命令面板（Cmd/Ctrl + Shift + P）并执行 Developer: Open Process Explorer 命令。

该工具会展示 Cursor 运行的所有进程，包括核心进程、扩展相关进程以及终端进程。通过此界面可立即识别高资源占用的进程：

  • 若问题进程位于 extensionHost 下拉项中，表明是扩展程序引发的问题，请尝试禁用相关扩展
  • 若问题进程位于 ptyHost 下拉项中，表明是终端进程占用过高资源。该工具会显示每个运行中的终端及其执行的命令，方便您终止进程或诊断资源占用问题
  • 若问题来自其他进程类型，请在官方论坛发帖反馈，我们将协助诊断

监控系统资源​

根据操作系统不同，您可以使用多种工具监控系统资源：

  • Windows：任务管理器
  • MacOS：活动监视器
  • Linux：系统监视器或 top 命令

这有助于判断问题是 Cursor 特有还是系统全局性问题。

最小化环境测试​

若上述步骤未能解决问题，可尝试在最小化环境中运行 Cursor 进行测试：

  1. 备份当前设置（~/.cursor 目录）
  2. 临时重命名该目录（例如改为 ~/.cursor-backup）
  3. 重新启动 Cursor（此时会生成全新配置）
  4. 观察问题是否依然存在

若问题消失，则可能是原有配置或扩展导致。您可逐步恢复配置/扩展以定位具体原因。

常见问题解答​

更新日志显示新版本但 Cursor 未更新​

若更新发布时间较短，可能尚未推送至您的设备。我们采用分阶段推送策略，即先向随机选取的部分用户发布新版本，随后逐步覆盖全体用户。通常您会在几天内收到更新推送。

GitHub 登录异常 / 如何注销 GitHub 账号​

您可通过命令面板 (Ctrl/⌘ + Shift + P) 执行 Sign Out of GitHub 命令进行注销操作。

无法使用 GitHub Codespaces​

目前我们暂未支持 GitHub Codespaces 功能。

Remote SSH 连接报错​

当前暂不支持通过 SSH 连接 Mac 或 Windows 设备。若您使用其他操作系统遇到问题，请前往论坛提交问题报告。提供相关日志将有助于我们快速定位问题。

Windows 系统 SSH 连接问题​

若出现错误提示 "SSH is only supported in Microsoft versions of VS Code"，请按以下步骤操作：

  1. 卸载当前 Remote-SSH 扩展：
  • 打开扩展视图 (Ctrl + Shift + X)
  • 搜索 "Remote-SSH"
  • 点击齿轮图标并选择 "Uninstall"
  1. 安装 0.113 版 Remote-SSH：
  • 访问 Cursor 扩展市场
  • 搜索 "Remote-SSH"
  • 选择 0.113 版本进行安装
  1. 安装完成后：
  • 关闭所有已建立 SSH 连接的 VS Code 实例
  • 完全重启 Cursor
  • 重新尝试 SSH 连接

若问题仍未解决，请检查 SSH 配置是否正确，并确保 SSH 密钥已正确设置。

企业代理环境下 Cursor Tab 和 Cmd K 失效​

Cursor Tab 和 Cmd K 默认使用 HTTP/2 协议以实现低资源占用与低延迟。部分企业代理（如特定配置下的 Zscaler）会拦截 HTTP/2 流量。解决方案：在设置中 (Cmd/Ctrl + , 搜索 http2) 添加配置项 "cursor.general.disableHttp2": true。

订阅专业版后应用仍显示免费套餐​

请尝试通过 Cursor 设置界面注销并重新登录账号。

用量重置周期查询​

专业版用户可点击控制面板中的 Manage Subscription，页面顶部将显示套餐续订日期。免费版用户可通过首次收到的邮件日期确定每月用量重置时间点。

更新后聊天/Composer 历史记录丢失​

若更新后发现历史记录被清空，通常是由于系统磁盘空间不足导致。Cursor 在磁盘空间不足时可能自动清理历史数据。预防措施：

  1. 更新前确保磁盘剩余空间充足
  2. 定期清理系统冗余文件
  3. 重要对话建议提前备份

如何卸载 Cursor​

请参考此指南进行卸载操作，注意将所有 "VS Code" 或 "Code" 替换为 "Cursor"，".vscode" 替换为 ".cursor"。

如何删除账号​

前往控制面板点击 Delete Account 按钮即可删除账号。此操作将永久清除所有关联数据。

通过命令行启动 Cursor​

在终端执行 cursor 命令即可启动。若未识别该命令：

  1. 打开命令面板 (⌘⇧P)
  2. 输入 install command
  3. 选择 Install 'cursor' command（可选安装 code 命令以覆盖 VS Code 的默认命令）

无法登录 Cursor​

若在设置界面的 "General" Tab 点击登录后跳转至 cursor.com 但返回仍显示登录按钮，请尝试暂时关闭防火墙或杀毒软件，此类软件可能拦截登录流程。