Win10 Ubuntu执行code .打开VS Code提示命令不存在如何解决

问题原因 #

Windows 10的WSL Ubuntu子系统默认未关联Windows端安装的VS Code执行路径，或VS Code安装时未勾选添加到系统PATH的选项，导致子系统终端无法找到code命令。

修复步骤 #

• 第一步：检查Windows端VS Code配置
  确保Windows系统已安装VS Code，安装时勾选*Add to PATH（添加到系统环境变量）*选项。如果安装时未勾选该选项，重新运行VS Code安装包选择「修改」，勾选对应选项后完成安装，重启WSL终端重试命令。
• 第二步：手动添加软链接（PATH配置不生效时使用，最稳定方案）
  WSL默认会将Windows系统的C盘挂载到/mnt/c/路径下，先找到你Windows端VS Code的code执行文件位置，默认路径为以下两种之一：
  • 用户级安装：/mnt/c/Users/你的Windows用户名/AppData/Local/Programs/Microsoft VS Code/bin/code
  • 全局安装：/mnt/c/Program Files/Microsoft VS Code/bin/code
    确认路径后，在WSL终端执行软链接创建命令，将VS Code执行文件映射到子系统的可执行目录，路径含空格时需要用英文双引号包裹：

  # 替换命令中的路径为你实际查到的code文件路径
  sudo ln -s "/mnt/c/Users/你的Windows用户名/AppData/Local/Programs/Microsoft VS Code/bin/code" /usr/local/bin/code
  

• 第三步：验证修复效果
  终端执行以下命令，若正常输出版本信息则配置生效：

  code --version
  

  此时再执行code .即可正常唤起VS Code打开当前WSL目录。

注意事项 #

• 不要直接在WSL内执行sudo apt install code安装Linux版本VS Code，WSL子系统无原生图形环境支撑，安装后无法正常唤起，且会和Windows端VS Code产生命令冲突。
• 建议在Windows端VS Code内安装WSL相关扩展，打开WSL目录时会自动完成环境适配，终端联动、代码调试等功能均可正常使用。

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