所有高级配置都可以在 Windsurf 设置中找到，您可以通过右上角的下拉菜单 → Windsurf 设置，或通过命令面板 (Ctrl/⌘+Shift+P) → 打开 Windsurf 设置页面来访问。

​
启用 Cascade 对 .gitignore 文件的访问

要让 Cascade 访问与项目 .gitignore 中模式匹配的文件，请前往您的 Windsurf 设置，然后找到“Cascade Gitignore Access”。默认情况下，它是关闭的。要提供访问权限，请单击切换按钮将其打开。

​
SSH 支持

VSCode 中通常的 SSH 支持由 Microsoft 授权，因此我们专门为 Windsurf 实现了自己的支持。它确实要求您安装 OpenSSH，但除此之外依赖项极少，应该像您习惯的那样“直接工作”。您可以在命令面板中的 Remote-SSH 下或通过左下角的 Open a Remote Window 按钮访问 SSH。此扩展在我们的内部开发中运行良好，但存在一些已知的注意事项和错误：

  • 我们目前仅支持 SSH 连接到基于 Linux 的远程主机。

  • 通常的 Microsoft “Remote - SSH” 扩展（以及 open-remote-ssh 扩展）将不起作用——请不要安装它们，因为它们与我们的支持存在冲突。

  • 我们目前还没有 Microsoft SSH 扩展的所有功能。我们主要只支持重要的功能：连接到主机。如果您有功能请求，请告诉我们！

  • 通过 SSH 连接到远程主机然后访问该远程主机上的 devcontainer 将不像在 VSCode 中那样工作。（我们正在努力！）目前，如果您想这样做，我们建议您改为在 devcontainer 内部手动设置 SSH 守护进程。这里是我们发现可行的设置方法，但请务必小心，确保它适合您的用例。

    1. 在 devcontainer 内部，运行一次此命令（多次运行可能会弄乱您的 sshd_config）
    sudo -s -- <<HERE
sed -i '/SSO SSH Config START/Q' /etc/ssh/sshd_config
echo "Port 2222" >> /etc/ssh/sshd_config
ssh-keygen -A
HERE
    1. 在 devcontainer 内部，在保持活动的终端中运行此命令（例如通过 tmux）
    sudo /usr/sbin/sshd -D
    1. 然后只需在 windsurf 中通过 SSH 连接到您的远程主机，但使用 port 2222。

  • SSH 代理转发默认开启，并将使用 Windsurf 与该主机的最新连接。如果您遇到问题，请尝试重新加载窗口以刷新连接。

  • 在 Windows 上，当要求您输入密码时，您会看到一些 cmd.exe 窗口。这是预期行为——我们很快就会解决这个问题。

  • 如果您遇到问题，请首先确保您可以在终端中使用常规的 ssh 连接到您的远程主机。如果问题仍然存在，请在任何 bug 报告中包含来自 Output > Remote SSH (Windsurf) 选项卡中的输出！

​
注意

  • Windsurf 目前不支持 SSH + Dev Containers，但我们计划在未来支持它。
  • 目前您只能通过 SSH 连接到基于 Linux 的远程主机（尽管您应该能够从所有平台通过 SSH 连接）。我们计划在未来支持 Windows 和 macOS。

​
Dev Containers (Beta)

Windsurf 为 Mac、Windows 和 Linux 提供了 Dev Containers 的 Beta 支持。要使用此功能，您的机器上必须安装 Docker，并且可以从 Windsurf 终端访问。

如果您想在本地运行开发容器，可以使用以下命令：

  1. 在容器中打开文件夹
    • 使用指定的 devcontainer.json 文件打开新的工作区。
  2. 在容器中重新打开
    • 在新的容器中重新打开当前工作区，指定 devcontainer.json 文件来配置容器。
  3. 附加到正在运行的容器
    • 如果您已经有 Docker 容器在运行，您可以将远程服务器附加到该容器，并将当前工作区连接到它。如果容器不遵循 Development Container Specificaton，我们将尽最大努力推断远程用户并进行相应设置。
  4. 在本地重新打开文件夹
    • 如果当前已连接到开发容器，您可以断开与容器的连接并在本地重新打开当前工作区。

如果您单击左下角的 Open a Remote Window 按钮，这些选项也会出现。

​
WSL (Beta)

从版本 1.1.0 开始，Windsurf 提供了对 Windows Subsystem for Linux 的 Beta 支持。您必须已经在您的 Windows 机器上设置并配置了 WSL。

您可以通过单击左下角的 Open a Remote Window 按钮，或在命令面板中的 Remote-WSL 下访问 WSL。

​
扩展市场

您可以更改用于下载扩展的市场。为此，请前往 Windsurf Settings 并在 General 部分修改 Marketplace URL 设置。

​
Windsurf 插件