wbmeet

如何安装并使用 Windsurf Cascade：安装编辑器、登录与第一个仓库任务

安装独立 Windsurf 编辑器、登录启用 Cascade，再在自己的仓库落地第一个可审查的 diff。

第一次用 Windsurf Cascade，卡住的通常不是提示词，而是编辑器有没有装对、有没有登录，以及仓库里第一件能审查的事。从官方下载独立编辑器，登录后用快捷键打开 Cascade，再改一行你自己能回滚的代码。

检索词是 如何安装并使用 Windsurf Cascade。下文对照官方入门与 Cascade 说明：windsurf.com、docs.devin.ai/windsurf。这是独立桌面 IDE（VS Code 系）里的代理，不是本站会议产品。要约短会对齐 diff，用 wbmeet 建房即可，步骤见 如何创建与加入房间。

安装编辑器登录仓库里的第一件事

先核对你装的是什么

Windsurf 是独立应用，不是必装进现有 VS Code 的扩展。Cascade 在登录后才完整可用。免费档可先试用，额度与模型以官方定价页为准。企业账号可能有管理员限制。

3 OS
macOS / Windows / Linux
L
Cmd 或 Ctrl + L 打开 Cascade
1 次
登录启用代理

第一次：安装、登录、改一行能审查的代码

  1. 1

    从官网安装编辑器

    打开 windsurf.com，选 macOS、Windows 或 Linux 安装包，按系统完成安装。不要从不明镜像抓。首次启动可导入 VS Code 设置、快捷键与扩展。

  2. 2

    登录以启用 Cascade

    用邮箱、Google 或 GitHub 登录或注册。跳过对话框后，命令面板搜索 Sign in，或点状态栏账号。未登录时 Cascade 面板常是空的或无法发送。

  3. 3

    打开自己的仓库

    File → Open Folder，选你拥有、能回滚的项目。不要对生产密钥目录做第一次实验。

  4. 4

    打开 Cascade 并给可审查任务

    Cmd+L（macOS）或 Ctrl+L（Windows/Linux），或侧栏 Cascade 图标。Write 会改文件，Chat 偏问答。先问「这个项目做什么、入口在哪」，再：「给一个没测试的辅助函数补单测，或给对外函数加输入校验。先出示 diff，等我 Accept。」不要把密钥写进提示。

# First hour · Windsurf Cascade · as of 2026-09
# 1. Download installer from https://windsurf.com
# 2. Sign in (email / Google / GitHub)
# 3. File → Open Folder → your repo
# 4. Cmd+L (macOS) or Ctrl+L (Windows/Linux)
# Write mode, then:
# "Add a unit test for one untested helper; show the diff and wait."

安装、模式、常见坑

路径官方怎么写第一次注意
独立编辑器windsurf.com 安装包不要从不明镜像装
登录账号后 Cascade 才完整跳过登录等于代理关闭
Write / Chat改文件 vs 问答改代码先确认 Write
快捷键Cmd/Ctrl+L没反应先查登录
扩展冲突VS Code 系可装扩展关掉打架的 Copilot 补全
01

Cascade 没反应

多半是未登录或令牌过期。登出再登录，重开编辑器。确认网络能连官方服务。

02

建议重复或互相打架

同时开着 GitHub Copilot 等补全时常见。先停掉竞争补全，只留 Cascade。

03

第一任务停在闲聊

问「项目做什么」只是热身。要有一条可审查改动，并在 Accept 前看 diff。

官方 Getting started 与 Cascade overview：先装独立编辑器并登录，再用 Cmd/Ctrl+L 打开 Cascade。命令与额度以官网为准。

编辑器 ≠ VS Code 插件必装
本页写独立 Windsurf。插件路径能力较少，第一次请用官方编辑器。
Write 与 Chat
要改文件用 Write；只要解释用 Chat，避免误 Accept 一堆 diff。
教程页不是会议说明书
只讲 Cascade 第一次。短会白板见 wbmeet 与 对照笔记。

还想核对的问题

一定要付费才能用 Cascade 吗？

官方提供可登录的免费档试用。额度、模型与进阶代理功能以当下定价与账号类型为准，不要假设无限额度。

可以只在现有 VS Code 里用吗？

有插件路径，但官方把完整代理能力放在独立 Windsurf。第一次请先装编辑器，再考虑插件。

快捷键没打开 Cascade？

先确认已登录。再试侧栏图标或命令面板。快捷键可能被导入的 VS Code 设置覆盖。

第一个任务必须改生产代码吗？

不必。先问项目做什么，再做可回滚的小事（单测或校验），并先看 diff。

免费开始开会