面向未来的编辑器，从今天开始。 Windsurf 是新一代 AI 驱动的 IDE，旨在让你始终保持专注与流畅。在本页，你将了解如何在电脑上安装 Windsurf、完成上手引导，并开启你的第一个 AI 驱动的项目。

Cascade

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

Usage

额度与使用情况。

Terminal

升级版终端体验。

MCP（模型上下文协议，Model Context Protocol）

MCP 服务器可扩展代理的能力。

Memories

Memories 与规则可用于定制行为。

上下文感知

即时理解你的代码库。

高级

高级配置选项。

工作流

自动化重复性流程。

应用部署

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

​
设置

开始前，请确保您的设备符合要求，点击下载链接，并按说明安装并运行 Windsurf。 如需了解如何更新 Windsurf，请点击此处。
最低操作系统版本：OS X Yosemite

​
入门

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

​
1. 选择设置流程

如果你从 VS Code 或 Cursor 迁移过来，可以轻松导入你的配置。否则，选择“Start fresh”。你也可以选择将 windsurf 安装到 PATH，这样就能在命令行直接运行 windsurf。
在此选择你的键位映射：默认 VS Code 映射或 Vim 映射。

​
2. 选择编辑器主题

从这些默认主题中挑选你喜欢的配色吧！不用担心，之后随时都能更改。请注意：如果你从 VS Code 导入配置，导入的主题会覆盖此处的选择。

​
3. 注册 / 登录

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

​
遇到问题？

如果你在此身份验证流程中遇到问题，也可以先登录，并手动向 Windsurf 提交身份验证代码。
点击“Copy link”按钮，将身份验证链接复制到剪贴板，然后在浏览器中打开该链接。

​
4. 开始冲浪！

推荐插件

了解我们精选的插件，助你更高效地使用 Windsurf！

​
更新 Windsurf

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

​
可尝试的操作

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

​
忘记导入 VS Code 配置了？

在完成初始设置后，如果你想再导入，也可以轻松将 VS Code/Cursor 的配置导入到 Windsurf。 打开命令面板（Mac：⌘+⇧+P，Windows/Linux：Ctrl+Shift+P），然后输入以下内容：

​
不兼容的扩展

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

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

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

​
Windsurf Next

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

​
卸载 Windsurf

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

关闭 Windsurf

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

删除 Windsurf 应用程序

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

移除配置文件

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

其他清理

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