WSL搭配VS Code使用时VS Code无法识别WSL安装环境如何解决

出现code .返回command not found、VS Code无法识别WSL环境的核心原因有两个：一是Windows侧VS Code未安装官方WSL对接扩展，本身不具备WSL环境识别能力；二是VS Code没有自动将WSL侧可用的调用脚本写入Ubuntu的环境变量PATH，你安装时勾选的Windows端PATH选项只对Windows系统终端生效，和WSL内的独立Linux环境PATH无关。

• 先装基础依赖：打开Windows端VS Code，进入扩展面板，搜索安装微软官方的WSL扩展，安装完成后彻底关闭VS Code再重启。没有这个扩展的前提下，VS Code原生不支持直接对接WSL文件系统，哪怕手动导航到WSL网络路径打开文件也会出现权限、路径识别错误。
• 修复code命令缺失问题：
  1. 重新打开VS Code，按下Ctrl+Shift+P调出命令面板，搜索并执行Shell Command: Install 'code' command in PATH选项。
  2. 把当前打开的所有WSL Ubuntu终端全部关闭，重新打开一个新的Ubuntu终端窗口，进入你的项目目录再执行code .即可。第一次执行时VS Code会自动在WSL侧部署配套的服务组件，等待10-20秒就会自动打开连接到WSL环境的VS Code窗口。
• 如果上述操作后还是提示command not found，手动补PATH配置：
  如果你是默认安装VS Code到C盘，在Ubuntu终端执行如下命令，把VS Code的Windows侧执行目录临时加入当前终端PATH做测试，注意把命令里的你的Windows登录用户名替换成你自己Windows系统的用户名：

  export PATH=$PATH:"/mnt/c/Users/你的Windows登录用户名/AppData/Local/Programs/Microsoft VS Code/bin"
  

  临时配置生效后执行code .测试，如果能正常唤起VS Code，就把这条export命令写入shell配置文件实现永久生效：用默认bash的话执行echo 'export PATH=$PATH:"/mnt/c/Users/你的Windows登录用户名/AppData/Local/Programs/Microsoft VS Code/bin"' >> ~/.bashrc && source ~/.bashrc，用zsh的话把配置写入~/.zshrc即可。
• 兼容问题排查：打开Windows PowerShell执行wsl -l -v，查看你安装的Ubuntu对应的VERSION列如果显示为1，执行wsl --set-version Ubuntu 2将发行版切换为WSL2，WSL1和VS Code WSL扩展存在已知兼容问题，切换完成重启终端即可正常使用。

注：Sublime Text可以正常打开WSL路径是因为它直接通过Windows的网络挂载路径访问文件，不需要和WSL内部环境做深度对接，和VS Code的WSL集成逻辑完全不同，不能作为环境配置正常的判断依据。

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