跳转到主要内容
面向明日的编辑器，今日即享。 Windsurf 是新一代 AI IDE，旨在让你始终保持高效流畅。在本页，你将了解如何在电脑上安装 Windsurf、完成上手引导，并开启你的第一个 AI 驱动项目。

Cascade

你的智能代理聊天助手，前所未有地与你协作。

用量

配额与用量。

终端

升级的终端体验。

MCP

MCP（模型上下文协议，Model Context Protocol）服务器可扩展代理的功能。

Memories

Memories 与规则有助于定制行为。

Context Awareness

即刻理解你的代码库。

Advanced

高级配置选项。

Workflows

自动化重复性的工作流程。

App Deploys

一键部署应用。
查看 Windsurf 的最新动态，请参阅我们的changelog！

​
设置

开始之前，请确保你的设备符合要求，点击下载链接，并按照说明安装并运行 Windsurf。 如果你想了解如何更新 Windsurf，请点击此处。
  • Mac
  • Windows
  • Ubuntu
  • Other Linux distributions
最低系统版本：OS X Yosemite

​
入门

启动 Windsurf 后，你会看到下方的页面。让我们开始吧！请注意，你随时可以通过使用 “Reset Onboarding” Command 重新开始此入门流程。

​
1. 选择设置流程

如果你从 VS Code 或 Cursor 迁移过来，可以轻松导入现有配置。否则请选择“Start fresh”。你还可以选择将 windsurf 安装到 PATH 中，这样就能在命令行直接运行 windsurf。
  • Start fresh
  • Import from VS Code
  • Import from Cursor
在这里选择你的按键映射：可使用 VS Code 默认映射或 Vim 映射。

​
2. 选择编辑器主题

从以下默认选项中挑选你喜欢的配色主题吧！别担心，之后随时可以更改。注意：如果你从 VS Code 导入，导入的主题将覆盖此设置。

​
3. 注册 / 登录

要使用 Windsurf，你需要使用你的 Windsurf 账号；如果还没有，请先创建一个。注册完全免费！
完成身份验证后，你会看到此页面。点击“Open Windsurf”，即可开始使用！

​
遇到问题？

如果你在此身份验证流程中遇到问题，也可以先登录，然后手动向 Windsurf 提交一个身份验证代码。
  • 1. 选择「遇到问题？」
  • 2. 输入身份验证代码
点击“复制链接”按钮，将身份验证链接复制到剪贴板，并在浏览器中打开该链接。

​
4. 开始冲浪吧！

推荐插件

浏览我们推荐的插件，充分释放 Windsurf 的潜力！

​
更新 Windsurf

要更新 Windsurf，您可以点击菜单栏右上角的“Restart to Update ->”按钮。
如果您没有看到该按钮，可以：
  1. 点击个人资料图标下拉菜单 > Check for Updates
  2. 在命令面板（Cmd/Ctrl+Shift+P）中 > “Check for Updates”

​
可尝试的内容

既然你已经成功打开 Windsurf，来试试一些功能吧！这些都可以在起始页面便捷访问。:)
在 IDE 右侧，你会看到一个名为“Cascade”的新面板。这是你的 AI 驱动代码助手！你可以在 Cascade 中进行 Chat、编写代码和运行代码！在此处了解其工作方式。
你可以使用 Cascade 创建全新项目！点击“New Project”按钮开始。
你可以通过 SSH 或本地开发容器打开文件夹，或连接到远程服务器。了解更多信息。
点击右下角的“Windsurf - Settings”按钮以打开设置面板。要访问高级设置，可在该面板中点击相应按钮，或在右上角个人资料下拉菜单中选择“Windsurf Settings”。
你可以使用快捷键 ⌘+⇧+P（Mac）或 Ctrl+Shift+P（Windows/Linux）打开命令面板。来探索可用命令吧！

​
忘了导入 VS Code 配置？

如果你在完成上手流程后才决定导入，也可以轻松将 VS Code/Cursor 的配置导入到 Windsurf。 打开命令面板（Mac: ⌘+⇧+P，Windows/Linux: Ctrl+Shift+P），然后输入以下内容：
  • VS Code
  • Cursor

​
不兼容的扩展

有一些扩展与 Windsurf 不兼容，其中包括其他 AI 代码补全扩展以及专有扩展。你无法通过任何市场在 Windsurf 中安装扩展。

​
自定义应用图标（测试版）

对于 Windsurf 的付费用户，您可以在停靠栏中为 Windsurf 选择不同的应用图标。目前此功能仅适用于 macOS，其他操作系统即将支持。 要更改应用图标，只需点击编辑器右上角的个人资料/设置图标，然后选择“Customize App Icon”。

​
Windsurf Next

Windsurf Next 是 Windsurf 的预发布版本。用户可以自愿加入，尽早体验最新功能与特性，即使这些功能尚未完全打磨。新功能通常会先在 Windsurf Next 上推出，随后不久进入稳定版。 你可以通过在此下载轻松加入 Windsurf Next。

​
卸载 Windsurf

要从系统中卸载 Windsurf，请按以下步骤操作：
1

关闭 Windsurf

在继续卸载前，请确保 Windsurf 未在运行。
2

删除 Windsurf 应用程序

  • Mac
  • Windows
  • Linux
将“应用程序”文件夹中的 Windsurf 拖到“废纸篓”。
3

移除配置文件

  • Mac/Linux
  • Windows
删除 Windsurf 配置文件夹：
rm -rf ~/.codeium/windsurf
4

其他清理

  • 如果你已将 Windsurf 添加到 PATH，请从系统的 PATH 环境变量中移除它。
  • 如果你通过系统的包管理器或控制面板安装了 Windsurf，也可使用相同方式卸载。
  • 清空“废纸篓”或“回收站”以完成卸载。