VSCode(WSL Bash终端)编译C++仅生成.out，调试需.exe文件

阿华AIGC实验室

2026-5-27

解决WSL Ubuntu下VS Code编译C++生成.out无法调试的问题

我之前也碰到过一模一样的坑！其实问题根源很简单：WSL里的g++默认生成的是Linux ELF格式的.out文件，而VS Code默认的调试器（如果没配置的话）是适配Windows PE格式.exe的，自然没法调试。而PowerShell里用的应该是Windows版的g++（比如MinGW或者MSYS2的工具链），所以直接生成.exe。

下面给你两个靠谱的解决方案，按需选就行：

方案一：配置VS Code用WSL的gdb调试.out文件（推荐）

这个方案不用改编译产物格式，直接让VS Code调用WSL里的调试器来调试Linux格式的可执行文件，流程更顺畅。

1. 完善你的tasks.json编译配置

把原来的tasks.json补全，确保编译时生成带调试信息的.out文件：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "WSL: Compile C++",
      "type": "shell",
      "command": "g++",
      "args": [
        "-g",          // 保留调试信息
        "main.cpp",    // 你的源文件
        "-o",          // 指定输出文件名
        "main.out"     // 生成的可执行文件
      ],
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": ["$gcc"]  // 让VS Code识别编译错误
    }
  ]
}

2. 创建/修改launch.json调试配置

在.vscode文件夹里新建或编辑launch.json，配置调试器使用WSL的gdb：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "WSL: Debug C++",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/main.out",  // 指向你的.out文件
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      "externalConsole": false,
      "MIMode": "gdb",
      "miDebuggerPath": "/usr/bin/gdb",  // WSL里gdb的路径
      "setupCommands": [
        {
          "description": "开启gdb美化打印",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ],
      "preLaunchTask": "WSL: Compile C++"  // 调试前自动执行编译任务
    }
  ]
}

配置完之后，按F5就能正常调试你的.out文件了！

方案二：在WSL里交叉编译生成.exe文件

如果你确实需要生成Windows格式的.exe，可以在WSL的Ubuntu里安装交叉编译器：

先安装交叉编译工具链：

sudo apt update && sudo apt install g++-mingw-w64

修改tasks.json里的编译命令，换成交叉编译命令：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Cross-compile to .exe",
      "type": "shell",
      "command": "x86_64-w64-mingw32-g++",  // 64位交叉编译器
      "args": [
        "-g",
        "main.cpp",
        "-o",
        "main.exe"
      ],
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": ["$gcc"]
    }
  ]
}

这样编译出来的.exe就能用Windows的调试器正常调试了，但这个方案不如方案一顺手，毕竟WSL的核心优势就是Linux环境嘛。

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