夜雨聆风你是不是也 听说 Windsurf 的 Cascade 能跨文件改代码，结果第一次打开就 误让 Agent 动了一堆文件？或者本来只想 问架构，却开在 会写盘的 Code 模式 里——本讲把入口和模式分清。
本节在系列里讲什么
Cascade 指南 共 10 讲：Plan/Ask、终端、Rules、MCP、Turbo 都会覆盖。本讲 只做 安装 Windsurf + 打开 Cascade + Code/Chat 分工；Plan 模式放第 3 讲。
官方文档链接（建议收藏）
- Cascade 总览（桌面）：https://docs.windsurf.com/windsurf/cascade/cascade
- Cascade 概览（插件侧对照）：https://docs.windsurf.com/plugins/cascade/cascade-overview
- Windsurf 入门：https://docs.windsurf.com/windsurf/getting-started
- 文档索引（llms）：https://docs.windsurf.com/llms.txt
安装与第一次打开
- 从 windsurf.com 下载 Windows / macOS / Linux 安装包（与 VS Code 系不同，是独立桌面 IDE）。
- 启动后用 Codeium 账号 登录（Cascade 模型与额度绑账号）。
- 用
Ctrl+L（Mac 为Cmd+L） 打开右侧 Cascade 面板；编辑器里 选中一段代码 再打开，会把选区自动带进上下文——我习惯 先选中再提问，少描述一行。
首次在某个文件夹工作时，Cascade 可能问 是否信任该目录（类似 VS Code 的 Workspace Trust）。陌生 clone 下来的仓库先别点全盘信任——看清路径是不是你的项目根。
Code 模式 vs Chat 模式
官方桌面版叫 Code 与 Chat（JetBrains 插件文档里写作 Write 与 Chat，是同一套逻辑）：
| 模式 | 能做什么 | 我什么时候用 |
|---|---|---|
| Code | 创建/修改/删除文件、跑终端、装依赖 | 明确要 落地改代码、重构、加功能 |
| Chat | 搜代码库、解释逻辑、答概念题 | 只问不改、读陌生仓库、比方案 |
默认往往是 Code。我踩过的坑：问「这段代码干什么的」却开在 Code——模型可能顺手提议改文件。纯阅读请 先切 Chat，确认方案后再切 Code 让其实施。
输入框下方有 模式切换；也可用 Ctrl+.（Mac Cmd+.）快速轮换（第 3 讲会加 Plan/Ask）。
工程向两句：别和 Cursor 单篇技巧混用
若你之前按 「打开文件夹 + 索引」 类单篇技巧用过别的 IDE，Cascade 的差异在 工具调用默认更激进——Code 模式会主动 Search、终端、改多文件。本系列按 官方 Cascade 文档 循序渐进；今天只要 装稳 + 模式切换顺手。
跟做清单
- [ ] 安装 Windsurf 并登录 Codeium 账号
- [ ]
Ctrl+L打开 Cascade，试一次「选中代码 → 提问」 - [ ] 在同一仓库分别用 Chat 问解释、Code 改一行注释（感受差异）
- [ ] 遇到 Trust 提示时，确认路径后再允许
- [ ] 收藏本讲 Cascade 与 getting-started 链接
下讲预告
下一讲细讲 Code/Chat 之外的 Plan 与 Ask，以及 什么时候先 Plan 再 Implement。
