VSCode远程调试Ubuntu C++代码，真香警告！

创作时间:

2025-01-22 00:33:21

作者:

@小白创作中心

VSCode远程调试Ubuntu C++代码，真香警告！

在C++开发中，调试是一个不可或缺的环节。传统的调试方式往往需要在本地环境中进行复杂的配置，而当项目需要在远程服务器上运行时，调试工作就变得更加繁琐。幸运的是，Visual Studio Code（简称VSCode）提供了强大的远程开发功能，让开发者可以在本地轻松调试远程服务器上的C++代码。本文将详细介绍如何使用VSCode进行远程调试，让你体验到这种高效开发方式的魅力。

为什么选择VSCode远程调试？

使用VSCode进行远程调试有以下优势：

跨平台开发：可以在Windows、macOS等本地系统上调试运行在Linux服务器上的程序，实现真正的跨平台开发。
一致的开发环境：所有开发工作都在远程服务器上进行，确保了开发环境与生产环境的一致性。
硬件资源利用最大化：可以利用服务器的强大计算能力，而无需升级本地硬件。
团队协作更便捷：所有代码和配置都存储在远程服务器上，方便团队成员共享和协作。

环境准备

在开始之前，确保你已经具备以下条件：

一台运行Ubuntu系统的远程服务器
本地安装了VSCode
服务器上已经安装了g++和gdb

安装Remote Development扩展包

首先，需要在VSCode中安装Remote Development扩展包。这个扩展包包含了Remote - SSH、Remote - Containers和Remote - WSL三个组件，其中Remote - SSH是我们需要的。

配置SSH连接

为了能够连接到远程服务器，需要配置SSH环境。如果你还没有SSH密钥，可以按照以下步骤生成：

打开终端，输入以下命令生成密钥对：
```
ssh-keygen -t rsa
```
按提示操作，通常可以直接按回车使用默认设置。
将公钥添加到服务器的~/.ssh/authorized_keys文件中：
```
ssh-copy-id user@your-server-ip
```

接下来，配置VSCode的SSH连接：

在VSCode中打开“远程资源管理器”侧边栏。
点击“设置按钮”，进入SSH配置界面。

修改~/.ssh/config文件，添加你的服务器信息：

Host your-server
    HostName your-server-ip
    User your-username
    IdentityFile ~/.ssh/your-private-key

创建配置文件

在开始调试之前，需要创建两个重要的配置文件：tasks.json和launch.json。

tasks.json：用于配置编译任务

在VSCode中打开命令面板（Ctrl+Shift+P），输入Tasks: Configure Task，选择Create tasks.json file from template，然后选择Others。

编辑生成的tasks.json文件，添加编译C++代码的命令：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build",
            "type": "shell",
            "command": "g++",
            "args": [
                "-g",
                "${workspaceFolder}/*.cpp",
                "-o",
                "${workspaceFolder}/app"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

launch.json：用于配置调试器

同样在命令面板中输入Debug: Open launch.json，选择C++ (GDB/LLDB)。

编辑生成的launch.json文件：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Remote Debug",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/app",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "build",
            "sourceFileMap": {
                "/mnt": "${env:HOME}/path/to/local/source"
            }
        }
    ]
}

实战演示

现在，让我们通过一个简单的C++项目来演示远程调试的过程。

在本地创建一个新的VSCode工作区，并将以下代码保存为main.cpp：

#include <iostream>
#include <thread>
#include <chrono>

void printHello() {
    std::cout << "Hello, World!" << std::endl;
}

int main() {
    std::thread t(printHello);
    t.join();
    return 0;
}