常见 Windsurf 问题
常见问题解答
我遇到了速率限制问题
我们受到速率限制，不幸的是，有时我们合作的高级模型会达到容量上限。我们正在积极努力提高这些限制并公平分配我们拥有的容量！
这不应该永远是问题。如果您收到此错误，请稍等片刻然后重试。
Pylance 或 Pyright 无法工作 / Python 语法高亮损坏或不佳
我们已经专门为 Windsurf 开发了一个 Pyright 扩展。请搜索“Windsurf Pyright”或将 @id:codeium.windsurfPyright 粘贴到扩展搜索中。
如何下载诊断日志并发送给 Windsurf 支持团队？
您可以通过前往您的 Cascade 面板，点击右上角的三个点，然后点击“下载诊断日志”来下载诊断日志。
在 MacOS 上，我看到一个弹窗：‘Windsurf’已损坏，无法打开。
此弹窗是由于 MacOS 安全功能的误报造成的。通常可以通过前往“系统设置 -> 隐私与安全性”并点击“允许”或“仍要打开”来解决 Windsurf 的问题。如果此方法失败或不可行，请尝试以下步骤：
- 确保 Windsurf 位于您的
`/Applications`文件夹下，并且您正在从该位置运行它。 - 检查您的处理器类型：如果您的 Mac 配备 Intel 芯片，请确保您下载的是 Intel 版本。如果是 Apple Silicon（如 M1、M2 或 M3），请确保您下载的是 Apple Silicon 版本。您可以从 Mac 下载页面 选择处理器类型。
- 尝试重新下载 DMG 文件并从 官方下载页面 重新安装，因为失效的安全功能通常在下载时触发。
- 确保 Windsurf（以及“Windsurf 已损坏”弹窗）已关闭，并运行
`xattr -c "/Applications/Windsurf.app/"`。
我在 Windows 上收到了关于更新的错误消息，或 Windows 上没有出现更新。
例如
更新已禁用，因为您正在以管理员身份运行 Windsurf 的用户范围安装。
Windsurf 在以管理员身份运行时无法自动更新。请以用户范围重新运行 Windsurf 以进行更新。
对于网络过滤器/防火墙、VPN 或代理，我应该将哪些域名列入白名单？
如果您使用了任何网络过滤、防火墙、VPN 服务或在网络访问受限的环境中工作，您可能会遇到 Windsurf 连接问题。为了确保顺利运行，请在您的网络配置中将以下域名列入白名单：
- *.codeium.com
- *.windsurf.com
- *.codeiumdata.com
在 Linux 上，Windsurf 静默无法启动，或启动时崩溃
这通常是由于 Electron 权限问题，VSCode 也有此问题，并且在使用 Linux tarball 时预期会出现这种情况。
最简单的解决方法是运行以下命令：
然后您应该能够启动 Windsurf。您也可以只运行带参数 `--no-sandbox` 的 `windsurf`，但我们不建议这样做。
如果此方法失败，请尝试以下方法。
我收到了一个错误消息，提示“Windsurf 启动失败”
请删除以下文件夹
Windows: `C:\Users\<YOUR_USERNAME>\.codeium\windsurf\cascade`
Linux/Mac: `~/.codeium/windsurf/cascade`
然后尝试重新启动 IDE。
我在 Windows 上收到了关于更新的错误消息，或 Windows 上没有出现更新。
一个例子
更新已禁用，因为您正在以管理员身份运行 Windsurf 的用户范围安装。
Windsurf 在以管理员身份运行时无法自动更新。请以用户范围重新运行 Windsurf 以进行更新。
我的 Cascade 面板变为空白
如果发生这种情况，请联系我们！如果您能提供屏幕录像将不胜感激。这通常可以通过清除您的聊天记录（`~/.codeium/windsurf/cascade`）来解决。