Windows 10 WSL 2 Ubuntu中 VSCode「code」命令路径类问题咨询

前置排查 #

先完成基础配置校验，跳过无效的环境变量调整操作：

• 确认Windows侧安装的VSCode已启用微软官方发布的WSL扩展，无禁用、加载报错状态
• 完全关闭所有已打开的WSL终端窗口，重新进入WSL Ubuntu环境，执行code .测试是否恢复正常

修复方案1：补全PATH环境变量关联 #

如果重启终端后依然提示Command 'code' not found，说明WSL环境未正确关联VSCode自动生成的启动脚本路径：

• 在WSL终端执行以下命令，确认启动脚本是否存在：

  ls /usr/local/bin/code
  

• 若脚本文件存在，先执行临时生效命令验证命令可用性：

  export PATH="$PATH:/usr/local/bin"
  

• 临时执行后若code命令可正常唤起VSCode，将配置写入用户级终端配置文件实现永久生效：
  1. 打开~/.bashrc文件，在文件末尾追加上述export开头的配置行
  2. 执行source ~/.bashrc重载配置，无需重启终端即可永久生效

修复方案2：重装WSL侧VSCode远程组件 #

如果执行上述ls命令时提示目标文件不存在，说明WSL侧的VSCode远程服务组件未正确部署：

• 打开Windows侧的VSCode，按下Ctrl+Shift+P调出命令面板
• 搜索并执行WSL: Reinstall VS Code Server in WSL，等待组件重装完成
• 重装过程会自动将code启动脚本写入WSL的默认可执行文件路径，全程无需手动调整系统配置

避坑提醒：不要直接将Windows系统内的VSCode安装路径手动添加到WSL的PATH环境变量中，这种方式启动的VSCode会跳过WSL远程适配层，出现文件权限异常、内置终端路径错位的兼容性问题。

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