WSL 已知问题

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

• 连接到 WSL 时，Devin Desktop 会明显变慢或出现卡顿
• 编辑器会频繁与 WSL 后端断开连接，并尝试重新连接
• 断连会在活跃开发过程中 (例如使用 Cascade 时) 以及编辑器空闲时发生
• Devin Desktop 会崩溃或失去响应，需要重启 IDE 和 WSL (wsl --shutdown)
• WSL 内存用量会随着时间推移不断增加，即使在配备 32 GB 以上 RAM 的系统上也是如此
• WSL 诊断日志中会显示大量 P9 Reply_Rlerror 事件 (文件未找到错误)
• 在 WSL 外使用 Devin Desktop 时，性能表现正常 (例如打开本地 Windows 文件夹)
• 常见的临时解决方法 (重启 WSL、重新安装 Devin Desktop、增加 .wslconfig 内存) 本身并不能解决该问题

• 使协议容量饱和
• 产生数千个“找不到文件”错误 (Reply_Rlerror)
• 导致 Devin Desktop 与 WSL 后端之间的连接中断
• 随着时间推移，进一步加重 WSL 内部的内存压力

wsl --update

wsl --shutdown

wsl --version

rm -rf ~/.windsurf-server

• 连接到 WSL 后，在 Devin Desktop 中打开“扩展”面板
• 检查安装在 WSL 环境中的扩展 (而不只是本地安装的扩展)
• 禁用或卸载你不需要的扩展——尤其是那些会大量监视文件或进行索引的扩展

• Vue (Volar) —— 已确认即使在非 Vue 项目中，它也会通过 9P 桥接造成过度的文件索引。仅卸载这一个扩展，就已经帮助多位用户解决了断连问题。
• 其他框架专用的语言扩展 (Angular、Svelte 等) 如果已安装但当前工作区并不需要，也可能出现类似情况。

[wsl2]
memory=16GB
swap=4GB
processors=4
autoMemoryReclaim=gradual

注意： autoMemoryReclaim 设置已在 WSL 2.7.3.0 及后续版本中移除。如果你使用的是 WSL 2.7.3.0+，请省略这一行。你可以使用 wsl --version 查看你的 WSL 版本。

wsl --shutdown

wsl --debug-shell

Invoke-WebRequest -UseBasicParsing "https://aka.ms/wsldiag" -OutFile wsldiag.ps1
.\wsldiag.ps1

• 先更新 WSL——许多问题只需运行 wsl --update 就能解决。WSL 2.7.3.0 及以上版本包含显著的稳定性改进。 (最简单的修复方法。)
• 如果你在 WSL 中安装了很多当前并不需要的扩展，或者曾从其他编辑器迁移过扩展，请尽量减少扩展数量。 (效果最明显的改动。)
• 如果 Devin Desktop 的服务器状态可能已损坏或陈旧 (例如更新失败后，或之前发生崩溃后) ，请执行干净重装服务器。
• 如果 WSL 占用了过多主机资源，或者你之前没有配置过资源限制，请优化 .wslconfig。 (可普遍提升 WSL 稳定性。)

• Devin Desktop 连接到 WSL 时报告 Error resolving authority / install script returned non-zero exit status
• WSL 本身工作正常 (wsl -d Ubuntu -- echo hello 可成功执行) ，但在 WSL 内运行 curl 会超时
• 安装或更新 VPN 或零信任软件后，开始出现该问题

[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true

wsl --shutdown
wsl -d Ubuntu -- bash -c "rm -f ~/.windsurf-server/.installation_lock"

注意： 需要 WSL 2.0.0 或更高版本。运行 wsl --version 检查版本，如有需要，运行 wsl --update 进行升级。