一行命令修复 WSL 中 VS Code 报 `Exec format error`

一行命令修复 WSL 中 VS Code 报 Exec format error

hey 这里是不做超级小白 喜欢我的内容的话请多多支持我~
最近小白在wsl中使用vscode编辑.config\starship.toml时，遇到了下面这样的报错：

问gpt5.5-thinking好久才找到原因（可能是遇到降智了

下面为大家先提供解决方案再深入探究原因

先给解决方法

在 WSL 里执行 code xxx 打开 VS Code 时，如果出现类似错误：

/mnt/d/Microsoft VS Code/bin/code: 62: /mnt/d/Microsoft VS Code/Code.exe: Exec format error

不要急着重装 VS Code，也不要先折腾 PATH。

第一步直接在 Windows PowerShell 里执行：

wsl --shutdown

快速验证是否修好了

重新进入 WSL 后，先执行：

notepad.exe

如果 Windows 记事本能正常打开，说明 WSL 调用 Windows 程序的能力恢复了。

再执行：

code .

如果 VS Code 能正常启动，问题解决。

---

为什么 wsl --shutdown 能解决这个问题？

这个问题的核心不是 VS Code 坏了，而是 WSL 和 Windows 之间的互操作机制短暂失效了。

WSL 有一个很重要的能力：你可以在 Linux 终端里直接运行 Windows 程序，比如：

notepad.exe
explorer.exe
code .

VS Code 官方文档也是这么推荐的：在 Windows 侧安装 VS Code 和 WSL 扩展，然后在 WSL 终端中执行 code . 来打开当前目录。首次运行时，VS Code 会拉取 WSL 端需要的组件。(Visual Studio Code)

也就是说，WSL 里的 code 并不是一个纯 Linux 程序。它最终会调用 Windows 侧的 Code.exe，再通过 Remote - WSL 机制连接到你的 Linux 环境。

正常情况下，WSL 看到你要运行一个 Windows .exe，会把它转交给 Windows 执行。微软的 WSL 配置中也明确有 [interop] 相关选项，用来控制是否允许从 WSL 启动 Windows 二进制程序；默认是开启的。(微软学习)

但当这个互操作状态临时异常时，WSL 就没有正确把 Code.exe 交给 Windows，而是尝试把它当成 Linux 程序直接执行。

于是就出现了：

Exec format error

因为 Windows 的 .exe 文件不是 Linux 的 ELF 可执行文件，Linux 内核当然执行不了。

为什么错误路径看起来像 VS Code 坏了？

报错里出现的是：

/mnt/d/Microsoft VS Code/bin/code: 62: /mnt/d/Microsoft VS Code/Code.exe: Exec format error

这容易让人/ai误判成：

• VS Code 安装坏了；
• /mnt/d/Microsoft VS Code/bin/code 脚本坏了；
• PATH 配置坏了；
• Remote - WSL 插件坏了。

gpt就一直让我查这几点。。。反复说

但从这个报错本身看，反而说明一件事：

/mnt/d/Microsoft VS Code/bin/code

这个脚本已经被找到了。

也就是说，至少在当时：

which code

大概率是能找到 code 的。

真正失败的是脚本内部调用：

/mnt/d/Microsoft VS Code/Code.exe

这一步。

所以问题不一定在 PATH，而是在 WSL 执行 Windows exe 的互操作链路上。

wsl --shutdown 到底做了什么？

wsl --shutdown 会关闭所有正在运行的 WSL 发行版和 WSL 2 虚拟机。微软文档也说明，wsl --shutdown 是快速重启 WSL 2 发行版的方式，不过它会关闭所有正在运行的发行版。(微软学习)

这一步的效果类似于：

1. 关闭当前 WSL 实例；
2. 清掉异常的 WSL 运行状态；
3. 重新初始化 WSL VM；
4. 重新加载 /etc/wsl.conf 等配置；
5. 重新建立 WSL 与 Windows 之间的互操作能力。

所以这个问题很多时候不是"配置永久错误"，而是"WSL 当前运行状态异常"。

这也是为什么你执行：

wsl --shutdown

然后重启 WSL 后，问题立刻恢复。

如何进一步排查

如果 wsl --shutdown 后仍然没有恢复，可以按下面顺序排查。

1. 检查 WSL 是否还能运行 Windows 程序

在 WSL 中执行：

notepad.exe

如果也报：

Exec format error

那就说明问题不是 VS Code 专属问题，而是 WSL 的 Windows 程序互操作整体异常。

如果 notepad.exe 能打开，但 code . 不行，再重点查 VS Code PATH 或 Remote - WSL。

2. 检查 code 指向哪里

在 WSL 中执行：

which code

可能看到类似：

/mnt/c/Users/你的用户名/AppData/Local/Programs/Microsoft VS Code/bin/code

或者：

/mnt/d/Microsoft VS Code/bin/code

这说明 WSL 找到了 Windows 侧 VS Code 的启动脚本。

VS Code 官方故障排查文档也提到，如果 WSL 中找不到 code，通常要检查 WSL 的 PATH 中是否包含 VS Code 安装目录，例如用户安装版路径或系统安装版路径。(Visual Studio Code)

但如果你的错误已经到了：

Code.exe: Exec format error

说明它不是简单的"找不到 code"，而是"找到了，但执行 Windows exe 失败"。

3. 检查 /etc/wsl.conf

在 WSL 中查看：

cat /etc/wsl.conf

重点看有没有这一段：

[interop]
enabled=false

如果有，就说明你禁用了 WSL 调用 Windows 程序的能力。

可以改成：

[interop]
enabled=true
appendWindowsPath=true

然后在 PowerShell 里执行：

wsl --shutdown

再重新进入 WSL。

微软文档说明，wsl.conf 是每个 WSL 发行版内部的配置文件，路径是 /etc/wsl.conf，它用于配置发行版级别的选项，包括与 Windows 系统的互操作行为。(微软学习)

---

不建议一上来就做的事

遇到这个错误时，不建议第一时间做这些操作：

sudo apt install code

这通常不是正确方向。WSL 场景下，VS Code 官方推荐的是安装 Windows 侧 VS Code，再通过 WSL 扩展和 code . 连接 WSL 环境。(Visual Studio Code)

也不建议立刻重装 VS Code。因为这个错误很多时候只是 WSL 当前运行状态异常，重启 WSL 就能解决。

也不建议盲目修改 .bashrc、.zshrc、config.fish。如果报错已经是 Code.exe: Exec format error，说明 code 命令路径多半已经找到了，真正的问题不在 shell 配置。

---

这个问题和 VS Code 命令面板里的 Shell Command 有关吗？

一般没太大关系。

有些AI会让你在 VS Code 命令面板里搜索：

Shell Command: Install 'code' command in PATH

但这更多是 macOS 或某些特定安装场景下的处理方式。

在 Windows 上，VS Code 安装时通常会通过安装器把 code 加入 PATH。官方文档也强调，安装 Windows 侧 VS Code 时应勾选 Add to PATH，这样才能方便地在 WSL 中使用 code 命令。(Visual Studio Code)

所以，当你的 WSL 报的是：

Code.exe: Exec format error

重点不应该放在"VS Code 命令面板为什么搜不到 Shell Command"，而应该先检查：

notepad.exe

能不能从 WSL 正常启动。

---

最小化排查流程

可以把下面这套流程当成固定模板。

第一步：直接重启 WSL

PowerShell：

wsl --shutdown

重新打开 WSL。

第二步：验证 Windows exe 互操作

WSL：

notepad.exe

能打开，说明 interop 基本正常。

第三步：验证 VS Code

WSL：

code .

能打开，问题解决。

第四步：如果还不行，查 PATH

WSL：

which code
echo $PATH | tr ':' '\n' | grep -i 'code'

常见路径包括：

/mnt/c/Users/<用户名>/AppData/Local/Programs/Microsoft VS Code/bin
/mnt/c/Program Files/Microsoft VS Code/bin
/mnt/d/Microsoft VS Code/bin

第五步：检查 interop 配置

WSL：

cat /etc/wsl.conf

建议保持：

[interop]
enabled=true
appendWindowsPath=true

然后 PowerShell：

wsl --shutdown

---

总结

这个错误：

Code.exe: Exec format error

表面上像是 VS Code 问题，实际上更常见的原因是 WSL 临时无法正确调用 Windows .exe 程序。

最直接有效的修复方式是：

wsl --shutdown

然后重新打开 WSL。

技术上看，code 命令从 WSL 启动 VS Code，依赖的是 WSL 与 Windows 之间的互操作机制。这个机制默认开启，但在 WSL 长时间运行、系统更新、配置变更、Remote 组件异常后，可能出现短暂失效。wsl --shutdown 会关闭并重新初始化 WSL 运行环境，因此能快速恢复这条互操作链路。

遇到这类问题，优先按顺序判断：

是不是 WSL 整体不能运行 Windows exe？
是不是 code 路径没找到？
是不是 /etc/wsl.conf 禁用了 interop？
是不是 VS Code Remote - WSL 组件异常？

不要一上来重装 VS Code，也不要盲目修改 shell 配置。先用最小操作恢复开发环境，再做进一步分析。