CLion 实现远程调试

深碍√TFBOYSˉ_ 2022-02-26 09:40 887阅读 0赞

CLion 是 JetBrains IDE 全家桶产品之一，可以用来开发 C/C++ 项目，而 GDB 则可以用来对 C/C++ 程序进行调试。

作为一款调试器，GDB 为程序开发人员提供了强大的调试功能，但却需要使用命令来执行调试操作，操作起来不是很方便。（有关 GDB 的使用，可以参考文章《GDB 调试》。）为此，CLion 为程序开发人员提供了图形化的调试界面以方便调试。另外，CLion 还提供了远程调试的功能。因为在实际项目中，我们常会碰到在本地开发环境编写代码，程序却在远程机器运行的情况。远程调试功能对我们来说是十分必要的。

本文讲述如何使用 CLion 来实现远程调试。

环境准备  
假设本地开发环境是 Windows 操作系统，程序远程执行环境是 CentOS 操作系统。为满足远程调试，需要在 CentOS 上安装必要的软件，安装的软件包括：

cmake  
gcc  
gdb  
gdbserver  
安装命令如下：

yum install cmake -y  
yum install gcc-c++ -y  
yum install gdb -y  
yum install gdb-gdbserver -y  
  
cmake 用于管理编译过程，生成 Makefile 文件；gcc-c++ 是编译器；gdb 是个调试工具，程序调试功能实际上就是由 gdb 提供的；gdbserver 用于监听某个 TCP 端口，允许远程主机连接，以实现远程调试功能。

至于本地开发环境，Windows 操作系统上安装好最新版本的 CLion ，以笔者为例，当前 CLion 最新版本为 2018.3。

代码同步  
使用 CLion 创建一个 C++ 项目 helloworld。然后，打开菜单 Tools - Deployment - Configuration，配置远程主机以及本地目录与远程目录的映射关系：

![2019-02-16-001953.jpg][]

![2019-02-16-002249.jpg][]  
右键项目文件夹，选择 Deployment - Upload to 10.88.115.114，便将项目源代码上传至 10.88.115.114 主机上。

上述我们配置了远程主机与本地主机目录映射，因此执行上传操作后，可以看到源代码已被上传至上述配置的目录中。

![2019-02-16-002124.jpg][]

代码编译  
CLion 为我们生成了默认的源代码main.cpp，修改 main.cpp，增加一个 add 函数，方便展示调试功能：

#include <iostream>
    
    using namespace std;
    
    int add(int a, int b)
    {
        int sum = a + b;
        return sum;
    }
    
    int main() {
        std::cout << "Hello, World!" << std::endl;
        int sum = 0;
        sum = add(5, 3);
        std:cout << "sum of 5 and 3 is " << sum << std::endl;
    
        return 0;
    }

修改 main.cpp 源代码后，需要重新将代码上传至远程机器。

CLion生成的 CMakeLists.txt 如下，使用 C++98 标准，指定生成的可执行文件名为 helloworld：

project(helloworld)
    
    set(CMAKE_CXX_STANDARD 98)
    
    add_executable(helloworld main.cpp)

由于上面我们已将源代码上传至 10.88.115.114 主机，进入 10.88.115.114 目录 /home/lihao/code/cpp/hello，然后执行以下操作：

$ cd /home/lihao/code/cpp/hello
    $ mkdir build
    $ cd build
    $ cmake .. -DCMAKE_BUILD_TYPE=Debug
    $ make

执行 cmake 命令会生成 Makefile 文件，指定 -DCMAKE\_BUILD\_TYPE=Debug 是为了支持 gdb 调试。

执行 make 命令会在 build 目录下编译生成可执行文件：helloworld。

远程调试  
经过上述的操作步骤，接下来我们就可以实施远程调试了。

在远程主机继续执行命令：

gdbserver :1234 /home/lihao/code/cpp/hello/build/helloworld

即指定 gdbserver 监听端口 1234，输出：

Process /home/lihao/code/cpp/hello/build/helloworld created; pid = 12496
    Listening on port 1234

返回本地 CLion，配置远程调试信息，增加一个 GDB Remote Debug 配置：

然后输入以下配置信息：

![2019-02-16-002509.jpg][]

![2019-02-16-002550.jpg][]

设置断点，按下调试按钮，可以看到程序已被执行起来，且中断在断点处，可以看到变量值：

![2019-02-16-002647.jpg][]

需要指出的是，helloworld 程序的运行是在远程主机，并不是本地主机，CLion 通过向 gdbserver 发送调试命令从而达到控制远程主机上的 gdb 的目的。

参考资料  
https://www.suninf.net/2018/07/clion-remote-debug.html  
CLion 的每日提示

[2019-02-16-001953.jpg]: /images/20220226/437c9fb85b1542b68dd6566349dc2663.png
[2019-02-16-002249.jpg]: /images/20220226/71d2828779884383b615faf0a4a7479d.png
[2019-02-16-002124.jpg]: /images/20220226/c2cbcaf0c1f44e0281787913e1ff5416.png
[2019-02-16-002509.jpg]: /images/20220226/6003c0709c7f40afa005bb74ca4c6a6a.png
[2019-02-16-002550.jpg]: /images/20220226/e12b527cd7f84e37a1b365351d350d39.png
[2019-02-16-002647.jpg]: /images/20220226/24dee2d3f3cf451a9a183c816dcfa7e4.png