用途：这是一份 Windsurf IDE 常见错误速查参考，用于诊断和修复 Cascade、Supercomplete、索引及扩展冲突等问题。前提是 Windsurf 已安装且此前可正常使用，并能访问其设置与日志。
主要能力与用法： Cascade 无响应时，检查网络与 https://status.windsurf.com，查看状态栏账户额度，执行命令面板中的“Cascade: Restart”，或“Reload Window”。 Supercomplete 无提示时，确认状态栏中自动补全已开启，检查文件类型与 .codeiumignore 是否排除该文件，并禁用 GitHub Copilot、TabNine 等冲突扩展；可在 settings.json 中确认 "editor.inlineSuggest.enabled": true 与 "codeium.autocomplete.enable": true。 索引卡顿或缓慢时，检查工作区规模，维护 .codeiumignore（如 node_modules/、.git/、dist/、build/、.next/、coverage/、vendor/、pycache/、.min.js、.bundle.js、*.map），可改为打开子目录，或执行“Codeium: Reset Indexing”。 扩展冲突方面，GitHub Copilot、TabNine 与 Supercomplete 冲突，Cody 与 Cascade 冲突，IntelliCode 可能干扰补全，需在扩展侧栏禁用其一。 Cascade 误改文件时，在提示中写明具体路径与约束，使用 .windsurfignore 保护敏感目录，接受前审查 diff 并用 Revert 回退，会话前先提交代码。 额度或模型不可用时，免费版每月 25 credits，可切换 SWE-1 Lite（无限）；Pro 版每月 500 credits，可在 windsurf.com/account 购买额外额度，或在 Cascade 模型下拉中切换模型。 MCP 未连接时，确认 Settings > Cascade > MCP 已启用，检查 ~/.codeium/windsurf/mcp_config.json，手动运行 MCP 命令，注意 ${VAR} 插值，并执行“Cascade: Restart MCP Servers”。 Cascade 丢失上下文时，保持单一任务会话，新任务新建对话，用 @ 提及重新注入上下文，将关键决策转为 Memories，长任务改用 Workflows。
限制：资料未提供各错误的完整根因分析、版本兼容范围及官方支持渠道细节，部分修复效果可能因环境而异。