​
常见问题

请先等待几分钟以完成更新。如果仍无效，请在网站上退出 Windsurf，重启你的 IDE，然后重新登录 Windsurf。此外，请确保已安装 Windsurf 的最新版本。
你可以在 Windsurf 网站上，点击右上角头像进入个人资料页面，取消付费方案。要取消 Pro 订阅，请在左侧导航中进入 账单 页面并点击“Cancel Plan”。要取消 Teams 订阅，请在左侧导航中进入 Manage Team 页面并点击“Cancel Plan”。
如我们的安全页面所述，你可以前往账户设置选择退出代码片段遥测。更多信息请参阅我们的服务条款。
你可以前往账户设置，向下滚动并点击“Delete Account”来删除你的账户。
如果你隶属于某个组织，请联系你的管理员。
你可以在我们的功能请求论坛上投票、评论并提交需求。你也可以在 Twitter/X 上联系我们！@windsurf

​
我遇到了请求频率限制问题

我们受到速率限制的影响，不幸的是，有时会达到我们所使用的高级 AI 模型的容量上限。我们正积极争取提高这些限制，并公平分配现有的容量。 这不会一直成为问题。如果你遇到此错误，请稍等片刻后再试。

​
Pylance 或 Pyright 无法正常工作 / Python 语法高亮失效或效果不佳

我们已开发了一个专为 Windsurf 的 Pyright 扩展。请搜索“Windsurf Pyright”，或在扩展搜索中粘贴 @id:codeium.windsurfPyright。

​
如何下载诊断日志并发送给 Windsurf 支持团队？

你可以打开 Cascade 面板，点击右上角的更多菜单（三个点），然后选择“Download Diagnostics”。

​
在 macOS 上，我看到一个弹窗：“Windsurf 已损坏，无法打开”。

该弹窗通常是 macOS 安全功能的误报。你可以前往“系统设置 -> 隐私与安全性”，对 Windsurf 点击“允许”或“仍要打开”来解决。如果这不起作用或不可行，请尝试以下步骤：
  1. 确保将 Windsurf 放在你的 /Applications 文件夹中，并从该位置运行。
  2. 检查你的处理器类型：如果你的 Mac 使用 Intel 芯片，请确保下载的是 Intel 版本；如果是 Apple Silicon（如 M1、M2 或 M3），请确保下载 Apple Silicon 版本。你可以在 Mac 下载页面 选择处理器类型。
  3. 尝试重新下载 DMG，并从官方下载页面重新安装，因为触发该安全功能的问题通常发生在下载时。
  4. 确保 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 上使用 tar 包时，这是预期行为。 最简单的修复方式是运行以下命令： 
            sudo chown root:root /path/to/windsurf/chrome-sandbox
            sudo chmod 4755 /path/to/windsurf/chrome-sandbox
然后你应该可以启动 Windsurf。你也可以直接运行 windsurf 并加上 --no-sandbox 参数，不过我们不建议这么做。 如果仍然不行，请尝试以下步骤。

​
我收到一条错误消息，显示“Windsurf failed to start”

警告：删除这些文件夹会清除你的对话历史和本地设置！
删除以下文件夹： Windows: C:\Users\<YOUR_USERNAME>\.codeium\windsurf\cascade Linux/Mac: ~/.codeium/windsurf/cascade 然后尝试重新启动 IDE。

​
我在 Windows 上收到与更新相关的错误消息，或者更新没有在 Windows 上显示。

示例：
已禁用更新，因为你正在以管理员身份运行 Windsurf 的用户范围安装。
当以管理员身份运行时，我们无法自动更新 Windsurf。请以用户范围重新运行 Windsurf 以进行更新。

​
我的 Cascade 面板变成空白

如果发生这种情况，请联系​​我们！非常感谢您提供屏幕录制。通常清除您的 Chat 历史记录（~/.codeium/windsurf/cascade）即可解决。