Windows 下 VSCode 连接 VMware 虚拟机搭建 C++ 开发环境（Ubuntu 为例）

接下来需要配置三个文件，在.vscode 下创建/修改 c_cpp_properties.json，添加以下内容

{
  "configurations": [
    {
      // 配置名称，在 VSCode 中显示为配置选项
      "name": "Linux",
      // 头文件搜索路径
      // "${workspaceFolder}/**" 表示包含工作区所有文件夹及其子文件夹
      "includePath": [
        "${workspaceFolder}/**",
        // 如果需要添加系统特定头文件路径，可以在这里添加，例如：
        // "/usr/local/include",
        // "/usr/include/c++/11"
      ],
      // 预处理器宏定义
      // 可以在这里定义项目特定的宏，例如：
      // ["DEBUG", "LINUX_BUILD"]
      "defines": [],
      // 编译器路径，指定使用的 G++ 编译器位置
      // 在 Ubuntu 系统中，这通常是 GCC/G++ 的标准安装路径
      "compilerPath": "/usr/bin/g++",
      // C 语言标准设置
      // "gnu17" 表示使用 GNU C17 标准（C17 带有 GNU 扩展，也可用不带 GNU 扩展的）
      "cStandard": "gnu17",
      // C++ 语言标准设置
      // "gnu++17" 表示使用 GNU C++17 标准（C++17 带有 GNU 扩展，也可用不带 GNU 扩展的）
      "cppStandard": "gnu++17",
      // IntelliSense 模式设置
      // "linux-gcc-x64" 表示针对 Linux 平台、GCC 编译器、x64 架构的智能感知
      "intelliSenseMode": "linux-gcc-x64",
      // 以下是一些可选但建议添加的配置项：
      // "compilerArgs": [
      // "-Wall",
      // 开启所有警告
      // "-Wextra",
      // 开启额外警告
      // "-O2"
      // 优化级别
      // ],
      // "browse": {
      // "path": [
      // "${workspaceFolder}/**",
      // "/usr/include",
      // "/usr/local/include"
      // ],
      // "limitSymbolsToIncludedHeaders": true
      // }
    }
  ],
  // 配置文件版本号，固定为 4
  "version": 4
}

在.vscode 下创建 tasks.json 文件，填入以下内容：

{
  "tasks": [
    {
      // 任务类型，cppbuild 表示这是 C/C++ 编译任务
      "type": "cppbuild",
      // 任务标签，在命令面板中显示的名称
      "label": "C/C++: g++ 生成活动文件",
      // 使用的编译器路径
      "command": "/usr/bin/g++",
      // 编译参数列表
      "args": [
        "-fdiagnostics-color=always",
        // 始终使用彩色诊断信息
        "-g",
        // 生成调试信息
        "${file}",
        // 要编译的当前活动文件
        "-o",
        // 指定输出文件
        "${fileDirname}/${fileBasenameNoExtension}"
        // 输出路径：同目录下与源文件同名的可执行文件
      ],
      // 执行任务的工作目录
      "options": {
        "cwd": "${fileDirname}"
        // 在源文件所在目录执行
      },
      // 问题匹配器，用于解析编译器输出并在问题面板显示错误/警告
      "problemMatcher": [
        "$gcc"
        // 使用 GCC 问题匹配器
      ],
      // 任务分组配置
      "group": {
        "kind": "build",
        // 属于构建组
        "isDefault": true
        // 作为默认构建任务
      },
      // 任务描述信息
      "detail": "调试器生成的任务。"
    }
  ],
  // 配置文件版本号
  "version": "2.0.0"
}

调试相关配置需要在.vscode/launch.json 文件添加

{
  // 配置数组，可以包含多个调试配置
  "configurations": [
    {
      // 配置名称，在调试下拉菜单中显示
      "name": "C/C++: g++ 构建和调试活动文件",
      // 调试器类型，cppdbg 表示使用 C++ 调试器
      "type": "cppdbg",
      // 请求类型，launch 表示启动新程序进行调试
      "request": "launch",
      // 要调试的程序路径
      // 使用变量：当前文件所在目录 + 当前文件名（无扩展名）
      "program": "${fileDirname}/${fileBasenameNoExtension}",
      // 传递给程序的命令行参数
      "args": [],
      // 是否在程序入口点（main 函数）自动暂停
      "stopAtEntry": false,
      // 调试器的工作目录
      "cwd": "${fileDirname}",
      // 环境变量设置
      "environment": [],
      // 是否使用外部控制台（false 表示使用 VSCode 集成终端）
      "externalConsole": false,
      // 调试器模式，gdb 表示使用 GNU 调试器
      "MIMode": "gdb",
      // 调试器初始化命令
      "setupCommands": [
        {
          "description": "为 gdb 启用整齐打印",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        },
        {
          "description": "将反汇编风格设置为 Intel",
          "text": "-gdb-set disassembly-flavor intel",
          "ignoreFailures": true
        }
      ],
      // 调试前执行的任务名称，必须与 tasks.json 中的 label 完全匹配
      "preLaunchTask": "C/C++: g++ 生成活动文件",
      // GDB 调试器的路径
      "miDebuggerPath": "/usr/bin/gdb"
    }
  ],
  // 配置文件版本号
  "version": "2.0.0"
}

测试 c++ 代码运行，直接点击运行，或者用命令行编译运行，可以看到已经成功输出，后面的 gdb 打印是程序执行完毕后正常打印

接下来打个断点，点击调试或者按 F5 可进入调试阶段，可以看到调试正常运行，可在控制台看到调试相关信息

注意事项

🚨 常见问题与解决方案

1. 连接问题

• 问题描述：SSH 连接失败，提示"Connection refused"或超时。
• 解决方案：
  • 检查 SSH 服务：确保虚拟机 SSH 服务正常运行 sudo systemctl status ssh。
  • 确认 IP 地址：虚拟机 IP 可能变更，每次启动后使用 ip addr 确认。
  • 检查防火墙：Ubuntu 默认防火墙通常不会阻止 SSH，如遇问题可尝试 sudo ufw allow ssh
• 问题描述：权限错误，提示"Permission denied"。
• 解决方案：
  • 检查用户名和密码是否正确。
  • 如需免密登录，可配置 SSH 密钥。

2. 环境配置问题

• 问题描述：VSCode 中 C++ 扩展功能不正常（如无法跳转定义、智能提示失效）。
• 解决方案：
  • 确保 C++ 扩展安装在远程：在 VSCode 扩展界面，确认 C/C++ 扩展显示"已安装在 SSH：目标地址"。
  • 检查编译器路径：在 c_cpp_properties.json 中确保 compilerPath 正确（如 "/usr/bin/g++"）。
  • 重新扫描编译器：在远程环境中，按 Ctrl+Shift+P，执行"C/C++: 编辑配置"。
• 问题描述：编译错误，提示"g++: not found"或类似信息。
• 解决方案：
  • 安装编译工具：sudo apt install build-essential gdb。
  • 验证安装：在虚拟机终端执行 g++ --version。

3. 调试与运行问题

• 问题描述：调试器无法启动，提示"Unable to start debugging"。
• 解决方案：
  • 检查 GDB 路径：在 launch.json 中确保 miDebuggerPath 正确（如 "/usr/bin/gdb"）。
  • 检查 preLaunchTask：launch.json 中的 preLaunchTask 需与 tasks.json 中的 label 完全一致。
  • 验证程序路径：program 字段指向的可执行文件路径需正确。
• 问题描述：调试过程中 GDB 卡住或无响应。
• 解决方案：
  • 可尝试使用 CMake Tools 插件作为替代方案。
  • 检查虚拟机资源（内存、CPU）是否充足。
• 问题描述：库版本不兼容（如 glibc、libstdc++ 版本问题）。
• 解决方案：
  • 升级远程主机库：sudo apt-get update && sudo apt-get upgrade libc6 libstdc++6。
  • 考虑使用静态链接的 VSCode 服务器或容器方案。

总结

本文详细讲解了如何在 windows 环境下通过 vscode 连接虚拟机搭建 c++ 开发环境，我个人一般是在虚拟机上做学习作用，虽然是在本机虚拟机上实现，但是实际工作中连接物理服务器是类似的操作。