本章收录 Cursor 在首次部署和账号接入阶段最高频的几类问题，按安装前、启动时、登录后三个环节归类，方便快速对号入座。
1. 下载与安装阶段
| 现象 | 常见原因 | 解决方法 |
|------|---------|---------|
| Windows 提示"Windows 已保护你的电脑" | 系统拦截未签名应用 | 点击"更多信息" → "仍要运行"；若被杀毒软件隔离，将其恢复并添加信任 |
| macOS 提示"无法打开，因为无法验证开发者" | Gatekeeper 安全策略 | 系统设置 → 隐私与安全性 → 安全性 下方点击"仍要打开"。仅需操作一次 |
| Mac 启动后明显卡顿、发热 | 错装 Intel 版本（官网通常自动识别，但偶发偏差） | 重新下载 Apple Silicon (ARM64) 版本覆盖安装 |
| Linux .deb 安装报错依赖 | 缺少系统库 | 先执行 sudo apt --fix-broken install，再重新安装 |
| Linux 界面模糊或光标异常 | Wayland 兼容性 | 终端启动时附加参数：cursor --ozone-platform=x11 |
2. 启动与配置阶段
| 现象 | 常见原因 | 解决方法 |
|------|---------|---------|
| 双击后无反应或白屏 | GPU 渲染冲突或插件兼容性问题 | 命令行启动并禁用 GPU：cursor --disable-gpu；若能正常启动，可在快捷方式追加该参数 |
| 导入 VS Code 配置后崩溃/卡死 | 个别 VS Code 插件与 Cursor 内核不兼容 | 删除 Cursor 配置目录强制重置（见下方"完全重置"），重启后先不导入，再逐个排查插件 |
| 首次启动找不到中文界面 | Cursor 目前仅提供英文界面 | 界面语言暂不支持切换，但所有 AI 对话均可使用中文输入 |
3. 登录与授权阶段
| 现象 | 常见原因 | 解决方法 |
|------|---------|---------|
| 浏览器授权完成后，Cursor 一直显示"Waiting for sign in…" | 企业内网、代理或广告拦截插件阻止了自定义协议回调 | 保留浏览器页面，复制页面上的授权码（Authorization Code），回到 Cursor 客户端粘贴确认（详见 2.2.1） |
| 登录提示"Network Error" | 客户端无法连接到 cursor.com | 检查系统代理是否开启；国内网络环境建议开启系统级/TUN 代理，仅浏览器插件代理无法覆盖桌面应用 |
| 提示"Too many requests" | 短时间内频繁触发登录验证 | 等待 5–10 分钟后重试，避免连续点击 |
| 登录成功但 AI 面板提示"Sign in to use AI" | 本地状态缓存未同步 | 完全退出 Cursor（含系统托盘图标），重新启动；若仍无效，执行"完全重置"后重新登录 |
4. 完全重置 Cursor（卸载残留清理）
如需彻底清空账号状态、缓存和配置，卸载后手动删除以下目录：
- Windows：
%APPDATA%\Cursor与%USERPROFILE%\.cursor - macOS：
~/Library/Application Support/Cursor - Linux：
~/.config/Cursor
删除后重新安装，Cursor 会回到初始状态，可重新选择是否导入 VS Code 配置。