Windsurf Cascade 命令一直显示 running,但终端里其实已经跑完,通常是终端集成没有正确识别命令结束。Windsurf 官方常见问题里也提到,这可能和默认终端配置、Shell 主题或复杂 prompt 有关。
先看命令是不是真没结束
打开终端面板,确认命令是否还在运行。如果终端已经回到提示符,但 Cascade 还显示 in progress,问题更可能在 IDE 识别终端状态,而不是命令本身。
先点开命令输出,不要立刻重启项目。很多时候测试已经跑完,只是 Cascade 没拿到结束信号。
设置默认终端
Windsurf 文档建议显式设置默认终端 profile。进入设置,搜索 terminal default profile,选择你实际使用的 shell。不要让 IDE 在多个 shell 之间猜,尤其是 Windows 上 PowerShell、Git Bash、WSL 混用时。
如果你在 macOS 或 Linux 使用 zsh,也要检查主题。
关闭复杂 Shell 主题
Powerlevel10k、复杂右提示符、启动横幅、自动环境检测脚本,都可能让 Cascade 判断输出异常。先临时换成简单 prompt,再测试同一条命令。
如果简单 prompt 解决问题,就给 Windsurf 终端单独准备一套轻量配置,不必影响你外部终端。
仍然卡住怎么办
清理 Cascade 本地历史或重启 IDE 可以作为后手,但不要第一步就删配置,因为这可能丢掉会话和设置。先从默认终端、Shell 主题、命令交互输入三个方向排查。
结论:Cascade 卡在 running,很多时候不是 AI 不会跑命令,而是终端结束信号没被识别。先让终端环境变简单,问题通常更好定位。