WSLにVSCodeで接続できない問題とその対処法

はじめに

ここ最近，Webアプリの実装のためにMac PCでコーディングしていたのですが，久しぶりにGPUを必要とするコードの実装をすることになったので，WSLを起動しました．

すると，エラーを吐いてVSCodeでWSLに接続できない......
VSCodeを使わずにWSL上のUbuntuにアクセスしたところ普通に接続できてしまう......

というわけで，この対処法について備忘録的にまとめてみたいと思います．

エラー内容

VSCodeのエラーを確認していくと，以下のようなエラーが発生していることがわかります．
どうやらminimistとやらが見つからないようです．

[2024-09-26 23:30:10.627] node:internal/modules/cjs/loader:1148
[2024-09-26 23:30:10.627]   throw err;
[2024-09-26 23:30:10.627]   ^
[2024-09-26 23:30:10.627] 
[2024-09-26 23:30:10.627] Error: Cannot find module 'minimist'
[2024-09-26 23:30:10.627] Require stack:
[2024-09-26 23:30:10.627] - /home/***/.vscode-server/bin/38c31bc77e0dd6ae88a4e9cc93428cc27a56ba40/out/server-main.js
[2024-09-26 23:30:10.627]     at Module._resolveFilename (node:internal/modules/cjs/loader:1145:15)
[2024-09-26 23:30:10.627]     at Module._load (node:internal/modules/cjs/loader:986:27)
[2024-09-26 23:30:10.627]     at Module.require (node:internal/modules/cjs/loader:1233:19)
[2024-09-26 23:30:10.627]     at require (node:internal/modules/helpers:179:18)
[2024-09-26 23:30:10.627]     at Object.<anonymous> (/home/***/.vscode-server/bin/38c31bc77e0dd6ae88a4e9cc93428cc27a56ba40/out/server-main.js:4:9763)
[2024-09-26 23:30:10.627]     at Module._compile (node:internal/modules/cjs/loader:1358:14)
[2024-09-26 23:30:10.627]     at Module._extensions..js (node:internal/modules/cjs/loader:1416:10)
[2024-09-26 23:30:10.627]     at Module.load (node:internal/modules/cjs/loader:1208:32)
[2024-09-26 23:30:10.627]     at Module._load (node:internal/modules/cjs/loader:1024:12)
[2024-09-26 23:30:10.627]     at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:174:12)
[2024-09-26 23:30:10.627]     at node:internal/main/run_main_module:28:49 {
[2024-09-26 23:30:10.627]   code: 'MODULE_NOT_FOUND',
[2024-09-26 23:30:10.627]   requireStack: [
[2024-09-26 23:30:10.627]     '/home/***/.vscode-server/bin/38c31bc77e0dd6ae88a4e9cc93428cc27a56ba40/out/server-main.js'
[2024-09-26 23:30:10.627]   ]
[2024-09-26 23:30:10.627] }
[2024-09-26 23:30:10.627] 
[2024-09-26 23:30:10.627] Node.js v20.15.1
[2024-09-26 23:30:10.627] スタートアップの問題のヘルプについては、https://code.visualstudio.com/docs/remote/troubleshooting#_wsl-tips にアクセスしてください
[2024-09-26 23:30:10.628] NodeExecServer run: C:\Windows\System32\wsl.exe -d Ubuntu-22.04 -e kill 629
[2024-09-26 23:30:14.941] Download in background is enabled

対処法

色々調べてみると，MicrosoftのGithub Issueに同様の症状についての記載がありました．（英語で記載がありますが，日本語でも同じ内容を以下に記しておきます．）

VSCode以外でのディストリビューションへのアクセス

インストールしているディストリビューションをVSCode以外で開きます．
簡単な手法の一例として，スタートメニュー（winキーで開く）からインストール済みのディストリビューションを開く方法があります．

VSCodeのインストール関連ファイルの削除

エラーの原因になっている，VSCodeのためにインストールされたパッケージ群を削除します．一度，クリーンにしてから再度インストールします．

対象のディレクトリは~/.vscode-server/binです．以下のコマンドで削除できます．

remove_packages

rm -rf ~/.vscode-server/bin

上記のコマンドは強制的にディレクトリを削除してしまうものです．しっかりと，/home/<username>/.vscode-server直下のbinファイルを指しているかを確認するようにして下さい．

VSCodeで接続

上記の操作が完了したら，通常通り接続を試みて下さい．
私の場合はこれで無事に接続できました．

最後に

根本的な原因は分からないままですが，一先ずは解決したのでヨシとします．