VS Code内WSL Ubuntu-20.04终端启动报错，外部WSL运行正常

核心问题定位 #

这个报错对应的退出码4294967295是有符号返回值-1的无符号整数形式，本质是wsl.exe接收到了无效的发行版标识参数。结合你修改主目录名、重装Ubuntu-20.04、外部终端可正常启动WSL的场景，问题根源完全在VS Code的本地缓存：

• 修改主目录名、卸载重装WSL的过程中，VS Code没有同步更新缓存的发行版元信息
• 从你的报错日志就能看到，传给wsl.exe的参数是'-d', 'Ubuntu-20.04 (default)'——这里把带(default)后缀的系统显示别名，当成了实际的发行版注册ID，直接触发参数无效错误，自然启动失败

具体修复操作 #

1. 清除VS Code的WSL残留缓存 #

• 完全关闭所有VS Code进程，从Windows任务管理器结束全部Code.exe后台进程，避免配置文件被占用无法修改
• 打开文件资源管理器，在地址栏输入 %APPDATA%\Code\User\globalStorage\ms-vscode-remote.remote-wsl 回车进入对应目录
• 删除目录下所有记录旧发行版信息的缓存文件，重点删除distributions.json这类元信息文件，仅保留和当前重装后Ubuntu-20.04修改时间匹配的文件夹

2. 修正终端配置的WSL启动参数 #

• 重新打开VS Code，打开设置面板（快捷键Ctrl+,），搜索定位到「终端 > 集成 > 配置文件 > Windows」
• 找到已有的WSL Ubuntu相关配置项，核对两个核心配置：
  • 启动命令路径为 C:\WINDOWS\System32\wsl.exe
  • 启动参数仅保留 -d Ubuntu-20.04，必须删掉参数里多余的(default)字符串
• 如果配置里没有对应的WSL终端profile，手动新建即可：
  • 显示名称：WSL: Ubuntu-20.04
  • 启动路径：C:\WINDOWS\System32\wsl.exe
  • 参数：-d Ubuntu-20.04

3. 校验WSL实际的发行版注册名称 #

• 打开Windows独立的命令提示符（无需管理员权限），执行命令 wsl -l -v
• 核对输出列表中你的Ubuntu发行版的精确注册ID：注意(默认)/(default)是系统给默认发行版加的显示后缀，不属于注册ID的一部分
• 把核对到的精确注册ID填回VS Code的WSL终端启动参数中，执行 wsl --update 确保WSL核心组件版本和VS Code Remote-WSL扩展兼容

4. 重置Remote-WSL扩展状态 #

如果前面操作完成后依然报错：

• 打开VS Code扩展面板，找到WSL（ms-vscode-remote.remote-wsl）扩展
• 点击扩展详情页卸载按钮旁的下拉选项，选择「重置扩展状态」
• 重启VS Code后重新连接WSL环境，打开内置终端验证启动是否正常

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