WSLの既知の問題

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

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

• WSL に接続していると、Devin Desktop の動作が明らかに遅くなったり、重くなったりする
• エディタが WSL バックエンドから頻繁に切断され、再接続を繰り返す
• 切断は、アクティブな開発中 (例: Cascade の使用中) と エディタがアイドル状態のときの両方で発生する
• Devin Desktop がクラッシュしたり応答しなくなったりして、IDE と WSL の両方を再起動する必要がある (wsl --shutdown)
• 32 GB 以上の RAM を搭載したシステムでも、WSL のメモリ使用量が時間の経過とともに増加する
• 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 は成功する) 、curl も WSL 内で実行できるがタイムアウトする
• 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 を実行してアップグレードしてください。