WSL2中无法执行code命令的问题求助

环境信息 #

VSCode版本： 1.103.2(system setup)
WSL2信息： Linux 8Q-PC 6.6.87.2-microsoft-standard-WSL2 #1 SMP PREEMPT_DYNAMIC Thu Jun 5 18:30:46 UTC 2025 x86_64 x86_64 x86_64 GNU/Linux

问题详情 #

在WSL2独立终端中输入code命令时，系统提示Command 'code' not found。已尝试以下操作但无效：

• 关闭所有VSCode窗口，在WSL2中执行rm -rf ~/.vscode*
• 运行wsl --shutdown后重启VSCode和WSL2
• 多次重装VSCode

另外：

• 在VSCode内置的WSL终端中输入code命令可正常运行
• 通过whereis code查询到路径为code: /root/.vscode-server/bin/6f17636121051a53c88d3e605c491d22af2ba755/bin/remote-cli/code，但直接在WSL2终端运行该路径命令时，提示Command is only available in WSL or inside a Visual Studio Code terminal.

解决方案 #

• 检查Remote-WSL扩展状态
  打开VSCode扩展面板（Ctrl+Shift+X），搜索「Remote - WSL」，确认扩展已安装并启用。若已安装，可尝试禁用后重新启用，再重启VSCode连接WSL2。

• 手动创建软链接到系统PATH目录
  在WSL2终端执行以下命令：

  # 替换为你查到的code实际路径
  sudo ln -s /root/.vscode-server/bin/6f17636121051a53c88d3e605c491d22af2ba755/bin/remote-cli/code /usr/local/bin/code
  sudo chmod +x /usr/local/bin/code
  

  执行后直接输入code测试是否可用。

• 确认PATH环境变量包含目标目录
  执行echo $PATH查看是否包含/usr/local/bin，若未包含，将其添加到shell配置文件：

  # 针对bash用户
  echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.bashrc
  source ~/.bashrc
  
  # 针对zsh用户
  echo 'export PATH="$PATH:/usr/local/bin"' >> ~/.zshrc
  source ~/.zshrc
  

• 重置VSCode的WSL服务器

  1. 在VSCode中按Ctrl+Shift+P打开命令面板，输入「Remote-WSL: Uninstall WSL Server」并执行
  2. 关闭所有VSCode窗口，执行wsl --shutdown
  3. 重新打开VSCode，连接到WSL2，等待服务器自动重新安装完成后测试code命令

内容的提问来源于stack exchange，提问作者Veitor