Cursor 官方文档中文版
  1. 故障排除
Cursor 官方文档中文版
  • 快速入门
    • 简介
    • 安装
    • 常见问题 (FAQ)
  • 使用手册
    • 编辑器迁移
      • 从 VS Code 迁移
      • 从 JetBrains IDE 迁移
    • 支持的语言与框架
      • JavaScript 与 TypeScript
      • iOS 与 macOS(Swift)
      • Java
  • 编辑器
    • AI 生成提交信息
    • 记事本功能(Beta)
    • 键盘快捷键
    • 标签页管理
      • 概述
      • 标签页 vs GitHub Copilot
      • 自动导入依赖
      • 高级功能
    • 智能会话 (Chat)
      • 概述
      • 智能体模式
      • 问答模式
      • 自定义模式
      • 工具集
      • 应用更改
    • ⌘K
      • 概述
      • 终端命令(Cmd+K)
  • 上下文管理
    • 代码库索引
    • AI 行为规则
    • 忽略文件配置
    • 上下文协议 (Model Context Protocol)
    • @ Symbols
      • Overview
      • @Files
      • @Folders
      • @Code
      • @Docs
      • @Git
      • @Web
      • @Definitions
      • @Link
      • @Lint Errors
      • @Recent Changes
      • @Cursor Rules
      • @Notepads
      • @Summarized Composers
      • #Files
      • /command
  • 账户
    • 套餐与用量
    • 数据看板
    • 账单管理
    • 商业版
      • 快速入门
      • 成员与角色管理
      • 数据分析
      • 单点登录(SSO)
  • 设置
    • 模型管理
    • 自定义 API 密钥
    • 早期体验计划
  • 故障排除
    • 常见问题
    • 故障排除指南
    • 获取请求 ID
  1. 故障排除

常见问题

解决 Cursor 应用常见问题的指南,包括更新、登录和连接问题#

尽管我们努力使 Cursor 尽可能稳定,但有时还是会出现问题。以下是一些常见问题以及如何解决它们。

网络问题 (HTTP/2)#

Cursor 依赖 HTTP/2 协议来实现许多 AI 功能,因为它能够处理流式响应。如果您的网络不支持 HTTP/2,这可能会导致诸如无法索引您的代码以及无法使用 Cursor 的 AI 功能等问题。
在公司网络、使用 VPN 或使用像 Zscaler 这样的代理时,可能会出现这种情况。
为了解决这个问题,Cursor 现在提供了一个 HTTP/1.1 回退机制,虽然速度较慢,但可以让您使用 Cursor 的 AI 功能。您可以在应用设置(不是 Cursor 设置)中自行启用此功能,方法是按 CMD/CTRL + ,,然后搜索 HTTP/2。
然后,您应该启用 Disable HTTP/2 选项,这将强制 Cursor 使用 HTTP/1.1,并应解决该问题。
我们希望在将来添加自动检测和回退功能!

资源问题 (CPU、RAM 等)#

一些用户在 Cursor 中看到高 CPU 或 RAM 使用率,这可能会导致他们的机器速度变慢,或者显示有关高 RAM 使用率的警告。
虽然 Cursor 在处理大型代码库时可能会占用大量资源,但这通常不是大多数用户的情况,更可能是 Cursor 的扩展或设置存在问题。
如果您在 MacOS 上看到低 RAM 警告,请注意,对于某些用户来说,存在一个错误,可能会显示非常不正确的值。如果您看到此情况,请打开“活动监视器”(Activity Monitor)并查看“内存”选项卡以查看正确的内存使用情况。
如果您在 Cursor 中遇到高 CPU 或 RAM 使用率,请按照以下步骤诊断和解决该问题:

检查您的扩展#

虽然许多扩展程序都很有用,但有些会严重影响性能!
要测试这一点,您可以尝试从命令行运行 cursor --disable-extensions,以在不启用任何扩展程序的情况下启动 Cursor。如果性能有所提高,请逐步重新启用扩展程序,一个一个地识别出有问题的扩展程序。
您也可以尝试使用“扩展二分”(Extension Bisect)功能,这将帮助您确定哪个扩展导致了问题。您可以在此处阅读有关它的更多信息,但请注意,这可能只在问题是立即且明显的情况下才有用,而不是随着时间推移而恶化的问题。

使用进程资源管理器#

“进程资源管理器”(Process Explorer)是 Cursor 中内置的工具,允许您查看哪些进程正在消耗资源。
要打开它,请打开命令面板 (Cmd/Ctrl + Shift + P) 并运行 Developer: Open Process Explorer 命令。
这将打开一个新窗口,其中包含 Cursor 正在运行的所有进程的列表,这些进程既包括其自身执行的一部分,也包括运行扩展所需的任何进程以及您可能正在运行的任何终端。这应该会立即识别出任何正在消耗大量资源的进程。
如果该进程列在 extensionHost 下拉列表中,则表明某个扩展程序导致了问题,您应该尝试找到并禁用有问题的扩展程序。
如果该进程列在 ptyHost 下拉列表中,则表明某个终端正在消耗大量资源。“进程资源管理器”将显示正在运行的每个终端以及其中正在运行的命令,以便您可以尝试终止它或诊断其高资源使用率。
如果使用情况来自另一个进程,请在 论坛 中告知我们,我们将很乐意帮助诊断问题。

监控系统资源#

根据您的操作系统,您可以使用许多不同的工具来监控系统的资源。
这将帮助您确定问题是 Cursor 特有的,还是系统范围的问题。

测试最小安装#

虽然以上步骤应能帮助大多数用户,但如果您仍然遇到问题,可以尝试测试 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 仅在 Microsoft 版本的 VS Code 中受支持”,请按照以下步骤操作:
1.
卸载当前的 Remote-SSH 扩展:
打开扩展视图 (Ctrl + Shift + X)
搜索“Remote-SSH”
单击齿轮图标并选择“卸载”
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,您的计划续订日期将显示在顶部。
如果您是免费用户,您可以查看何时在收件箱中收到我们的第一封电子邮件。您的使用量将从该日期起每月重置。

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

如果您注意到在更新后清除了您的聊天或编辑器历史记录,这可能是由于系统上的磁盘空间不足。当磁盘空间有限时,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 的“设置”(Settings)选项卡的“常规”(General)选项卡上单击“登录”(Sign In),但被重定向到 cursor.com,然后返回到 Cursor 仍然看到“登录”按钮,请尝试禁用您的防火墙或防病毒软件,这些软件可能会阻止登录过程。
上一页
早期体验计划
下一页
故障排除指南
Built with