Windsurf IDE

Windsurf 是由 Codeium 推出的新一代 AI 集成开发环境（IDE），它基于 VSCode 构建，结合了强大的 AI 功能，旨在提升开发者的工作效率。

  • 不仅包括了代码生成和补全，还包含了 Agents，可以作为一个独立的个体来协助完成编码
  • Flows = Agents + Copilots
  • Cascade，更强的上下文感知能力，理解整个代码库，多文件编辑
  • Windsurf 甚至可以直接在终端安装依赖，协助完成环境搭建

1- Codeium 的兼容性

1.1- 支持的 IDE 和版本

  • VS Code：所有版本
  • JetBrains IDEs：2022.3 及以上版本（支持远程 SSH 的版本需要 2023.3 及以上）
  • Visual Studio：17.5.5 及以上版本
  • NeoVim：0.6 及以上版本
  • Vim：9.0.0185 及以上版本
  • Emacs：所有编译了 lbxml 的版本
  • Xcode：所有版本
  • Sublime Text：3 及以上版本
  • Eclipse：4.25 及以上版本（2022-09 及以上）

2- 系统要求与安装

在安装 Windsurf 之前，请确保你的设备满足以下最低系统要求：

  • 操作系统：
    • OS X Yosemite 或更高版本
    • Windows 10 或更高版本
    • Linux 发行版

2.1- 安装步骤

  1. 下载：

    • 访问 Codeium 官网。
    • 找到 Windsurf 的下载链接，选择适合你操作系统的版本进行下载。

  2. 安装：

    • 双击下载的安装包，按照提示进行安装。
    • 安装完成后，启动 Windsurf。

3- 初始设置（Onboarding）

启动 Windsurf 后，你将看到初始设置界面。可以通过以下步骤完成设置：

3.1- 选择设置流程

  • 导入 VS Code 配置：
    • 如果你之前使用过 VS Code，可以选择 “Import VS Code” 来导入你的配置。
  • 全新开始：
    • 如果你希望从头开始，可以选择 “Start fresh”。
  • 命令行访问：
    • 选择将 Windsurf 安装到 PATH 中，以便从命令行运行。

3.2- 选择编辑器主题

  • 选择你喜欢的颜色主题，Windsurf 提供了多种默认主题供选择。你可以在后续随时更改主题。

3.3- 注册/登录

  • 使用你的 Codeium 账户登录。如果没有账户，可以免费注册一个。
  • 登录成功后，点击 “Open Windsurf” 进入主界面。

4- 创建和管理项目

4.1- 创建新项目

  1. 在主界面中，点击 " 新建项目 "。
  2. 输入项目名称和选择项目路径。
  3. 选择所需的编程语言和框架（如 Python、JavaScript 等）。

4.2- 导入现有项目

  • 选择 " 导入项目 "，浏览并选择已有的项目文件夹，Windsurf 会自动识别项目结构。

5- 编写代码

5.1- 智能代码补全

  • Windsurf 提供 AI 驱动的智能代码补全功能。开始输入代码时，IDE 会根据上下文提供实时建议，帮助你快速完成代码。

5.1.1- 自动补全概述

5.1.2- 建议显示

1. 建议会以灰色文本显示在你输入时。你可以按`Esc`键取消建议，或者继续输入或导航以使建议消失。

5.1.3- 键盘快捷键

  1. 在编辑器中按下 Cmd + i ，可以使用自然语言生成或重构代码。直接在行内就可以呼唤出提示框。
  2. 自动补充
    1. 在我短暂的体验中，发现 Windsurf 的自动提示和补全确实要更智能一些，智能的点在于，它不是和传统的编辑器一样，会自动补全代码后面的内容，它会分析前后的代码内容，并且根据内容智能分析并提示，我在使用的过程中，因为从外部粘贴了几句话，但是文字中使用的标点是英文的逗号，但是在我的上下文中，全部都是使用的中文的符号，在我继续编码后面的内容的时候，它会自动提示我前面的内容从英文的逗号，变更为中文的逗号，并且我直接使用 Tab 就完成了四处逗号的替换。
  3. @ 引用符号
    1. 可以在对话框中通过 @ 符号来引用函数，类，文件，整个目录等等，将其加入到上下文中。
  4. 接受建议：按 Tab 键。
  5. 取消建议：按 Esc 键。
  6. 逐字接受建议：
    • 在 VS Code 中：按 Cmd + →。
    • 在 JetBrains 中：按 Alt + Shift + \。
  7. 下一个/上一个建议：按 Alt + ] 或 Alt + [。
  8. 触发建议：按 Alt + \。

5.1.4- 自动补全速度

1. 可以在设置中调整自动补全的速度。快速自动补全目前仅对Pro、Teams和Enterprise用户开放。

5.2- 多文件自动写入

  • 你可以在多个文件中进行自动写入，Windsurf 会自动同步更改，确保所有文件保持最新状态。

6- 调试和测试

6.1- 调试工具

  • 使用内置的调试工具，设置断点并逐步执行代码，查看变量值和程序状态。
  • 在调试面板中，可以查看调用堆栈、监视变量和控制执行流程。

6.2- 运行测试

  • Windsurf 支持多种测试框架（如 Jest、PyTest 等），可以轻松运行测试用例，确保代码的正确性。

7- 版本控制

  • Windsurf IDE 集成了 Git 支持，方便管理代码版本和协作开发。
  • 在侧边栏中，你可以查看版本历史、提交更改和解决合并冲突。

8- 高级功能

8.1- 上下文管理

  • Windsurf 具备强大的上下文管理能力，能够理解代码的结构和逻辑，从而提供更准确的建议和补全。

8.2- Cascade 功能

Cascade 是一个智能聊天机器人，能够实时协作并执行任务。

  1. 打开 Cascade：点击 Windsurf 窗口右上角的 Cascade 图标，或使用快捷键 Cmd+L。
  2. 模式选择：Cascade 有两种模式：
    1. Write 模式用于创建和修改代码
    2. Chat 模式用于回答关于代码库或编程原则的问题
  3. 实时协作：Cascade 能够实时感知用户的操作，无需额外提示上下文。
  4. 工具和终端访问：Cascade 可以检测并安装所需的包和工具。
  5. 回滚功能：用户可以回滚 Cascade 所做的更改，但回滚操作目前是不可逆的。

8.3- 高级功能

Windsurf 的 SSH 支持和开发容器（Dev Containers）功能。

  1. SSH 支持：Windsurf 实现了自己的 SSH 支持，允许连接到 Linux 主机。
    1. 虽然目前只支持 x64 架构的 Linux 主机，但未来可能会扩展到更多平台。
  2. 开发容器：
    1. Windsurf 支持在本地 Linux 机器上运行开发容器，提供了打开文件夹、重新打开工作区和附加到运行中的容器等功能。