linux 下使用 vscode 配置 makefile 编译调试c/c++程序

环境准备

  • ubuntu 环境
  • vscode安装包 code_1.72.2-1665614327_amd64.deb

vscode 安装和配置

安装vscode:

sudo dpkg -i code_1.72.2-1665614327_amd64.deb

打开vscode安装相关插件:

ctrl+shift+x开发扩展程序,安装如下插件:

  • chinese中文插件,安装完成后需要重启生效

  • c/c++插件,注意,这里默认状态的是最新版,需要点配置,选择安装另一个版本,选择 1.8.4版本,这个版本会自动生成 launch.jsontasks.json两个配置文件,方便使用

image-20221026195311276.png

配置vscode,使能加载makefile进行编译调试

测试代码示意

目录结构:

.
└── hello
    ├── hello.c
    ├── hello.h
    ├── main.c
    └── makefile

main.c

#include 

#include "hello.h"

int main(void)
{
    int a = 3;
    printf("你好! %d\n", a);

    for (int i = 0; i < a; ++i)
    {
        print_hello();
    }

    return 0;
}

hello.h

#ifndef _HELLO_H_
#define _HELLO_H_

int print_hello();

#endif

hello.c

#include 

#include "hello.h"

int print_hello()
{
    printf("hello world\n");

    return 0;
}

makefile

# 定义参数, := 表示常量,不能在用 = 或 += 修改变量的值
TARGET = main 
OBJ = main.o hello.o 
CC := gcc
CFLAGS = -g -Wall


# 格式:
# 目标文件 : 依赖文件
#   指令
#
# 说明:第一个目标文件就我的最终目标。递归执行子目标
$(TARGET):$(OBJ)
# $^: 表示依赖项;   $@:表示目标项
    $(CC) $(CFLAGS) $^ -o $@

%.o:%.c
    $(CC) $(CFLAGS) -c $^ -o $@

# 伪目标: .PHONY: 只没有依赖文件的目标
.PHONY:
clean: 
    rm -rf $(TARGET) $(OBJ)

配置vscode

使用vscode打开代码: 文件 -> 打开文件夹 -> 选择hello目录

打开 main.c, 按F5运行调试,选择调试器 C++(GDB/LLDB),

image-20221026201731304.png

选择配置gcc-9(这里可以任意选一个)

image-20221026201908517.png

,选择完成后,会提示错误信息如下,不用管他,点取消就行,这里主要是为了自动生成 launch.jsontasks.json两个默认配置

image-20221026202225162.png

点取消后,会发现多了launch.jsontasks.json两个配置文件

image-20221026202501524.png

下边主要是对这两个文件进行修改。

修改tasks.json,使支持使用make进行编译

{
    "tasks": [
        {
            "label": "build_debug", // 任务名称,调试时可以指定不用任务进行处理
            "type": "shell", // [shell, process], 定义任务作为作为进程运行还是在shell中作为命令运行; (测试没看出啥区别...)
            "command": "make", // 要执行的命令,可以是外部程序或者是shell命令。这里使用make编译命令
            "problemMatcher": [ // 要使用的问题匹配程序。可以是一个字符串或一个问题匹配程序定义,也可以是一个字符串数组和多个问题匹配程序。
                "$gcc"
            ],
            "group": { // 定义此任务属于的执行组。它支持 "build" 以将其添加到生成组,也支持 "test" 以将其添加到测试组。
                "kind": "build",
                "isDefault": true
            },
            "presentation": { // 配置用于显示任务输出并读取其输入的面板
                "echo": true, // 控制是否将执行的命令显示到面板中。默认值为“true”。
                "reveal": "always", // 控制运行任务的终端是否显示。可按选项 "revealProblems" 进行替代。默认设置为“始终”。
                "focus": false, // 控制面板是否获取焦点。默认值为“false”。如果设置为“true”,面板也会显示。
                "panel": "shared", // 控制是否在任务间共享面板。同一个任务使用相同面板还是每次运行时新创建一个面板。
                "showReuseMessage": true, // 控制是否显示“终端将被任务重用,按任意键关闭”提示
                "clear": false // 运行前清屏
            }
        },
        {
            "label": "build_release",
            "type": "shell",
            "command": "make",
            "args": ["CFLAGS = -O2"], // 编译参数, 替换makefile中让CFLAGS字段
            "dependsOn":["build_clean"], // 指定依赖让task, 即会先执行build_clean,然后再执行build_release
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        },
        {
            "label": "build_clean",
            "type": "shell",
            "command": "make",
            "args": ["clean"], // 相当于执行 make clean命令
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ],
    "version": "2.0.0"
}

这里我们配置了3个任务:

  • build_debug: 调试模式,这里使用makefile的默认配置,makefile中的CFLAGS默认有 -g 参数,可以生成调试信息
  • build_release: 生产模式,这里修改makefile中的 CFLAGS参数,去掉了 -g -Wall选项,使用 -O2进行优化
  • build_clean: 删除编译产生的.o文件、目标文件

这3个任务配置完成后,可以通过 ctrl+shift+b进行选择,手动选择执行哪一个

修改launch.json, 配置调试需要的相关信息:程序名、以及默认用哪个任务进行编译等,具体如下

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息,请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(gdb) Lauch", // 启动配置的下拉菜单中显示的名称
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/main", // 将要进行调试的程序的路径, workspaceFolder指当前工作目录(即vscode打开的目录:hello),main指的是makefile编译后目标码(可执行程序)的名字
            "args": [], // 程序启动的参数
            "stopAtEntry": false, // 设置true时,程序将暂停在程序入口处, 即main()的第一个{位置
            "cwd": "${workspaceFolder}", // 调试时的工作目录
            "environment": [],
            "externalConsole": false, // 调试时,是否显示控制台串口
            "MIMode": "gdb", // 调试命令
            "setupCommands": [
                {
                    "description": "为 gdb 启用整齐打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                },
                {
                    "description": "将反汇编风格设置为 Intel",
                    "text": "-gdb-set disassembly-flavor intel",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "build_debug", // 使用哪个任务进行编译,需要指定tasks.json中的一个,这里选择用build_debug任务进行编译
            "miDebuggerPath": "/usr/bin/gdb" // 调试命令的路径
        }
    ]
}

配置完成之后,可以按F5进行调试

你可能感兴趣的:(linux 下使用 vscode 配置 makefile 编译调试c/c++程序)