VSCode 调试

VSCode 调试

更全面的信息可以参考官方 调试手册 ,以下记录我用 VSCode 调试的一些经验。

调试配置

想要在 VSCode 里调试,需要配置两个文件 tasks.jsonlaunch.json

  • tasks.json:用于构建任务,也就是编译链接程序。
  • launch.json:用于配置调试环境,例如调试器(gdb),可执行文件路径等。

这两个文件按 F5 后会自动在 .vscode 目录下生成。

tasks.json

一般默认生成的 tasks.json 文件如下:

{
    "version": "2.0.0",
    "tasks": [
        {
            "type": "shell",
            "label": "C/C++: gcc build active file",
            "command": "/usr/bin/gcc",
            "args": [
                "-g",
                "${file}",
                "-o",
                "${fileDirname}/${fileBasenameNoExtension}"
            ],
            "options": {
                "cwd": "${workspaceFolder}"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": "build"
        }
    ]
}

我们需要关注的选项有:

  • "lable":任务标签,需与 "preLaunchTask" 保持一致。
  • "command":需要执行的命令,可以是一个外部程序或者 Shell 命令。
  • "args":传递给 "command" 的参数。

深入理解 tasks.json 文件的作用与 "command" 选项的用法,我们就能灵活地配置构建工程。

tasks.json 文件是用来构建工程的,当我们按 F5 进行调试时,VSCode 首先会执行 tasks.json 文件里 "command" 选项后的命令,并传入 "args" 参数,这样整个工程就被重新编译链接一遍了。

以 hello.c 文件和上述 tasks.json 为例,按 F5 进行调试时,最终会在命令行执行下述命令构建工程:

/usr/bin/gcc -g main.c -o main

当然,如果一个工程有多个文件,"command" 就不能是简单的 gcc 了,需要根据实际的构建系统选择。

如果构建系统使用的是 Makefile ,那我们可以配置

{ 
    "command": "make",
    "args": []
}

这样在构建项目时就会使用命令

make

这跟我们平时使用 make 构建项目是一致的。

又比如配置 Zephyr 环境,

{
    "command": "west",
     "args": [
         "build",
         "-b",
         "native_posix",
     ]
}

这样在构建项目时相当于执行命令

west build -b native_posix

launch.json

launch.json 文件用于配置调试环境。一般默认生成的文件如下:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "gcc - Build and debug active file",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "C/C++: gcc build active file",
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}

我们需要关注的选项有:

  • "program":可执行文件的的路径,相对路径或绝对路径都可以。
  • "args":运行程序时传递的参数。
  • "stopAtEntry":是否在入口处停止,若为 true 在调试时会默认在 main() 处停止。
  • "environment":配置程序运行的环境变量。
  • "preLaunchTask":调试会话启动前运行的任务,需与 tasks.json 里的 "label" 一致。若没有该选项,则按 F5 时会直接使用 "program" 程序调试,不会再试图重新编译一次。
  • "miDebuggerPath":调试器的路径,用途在后面有介绍。

VSCode 预定义了一些变量,可以在 Variables Reference 查看意思。

调试技巧

VSCode 以 root 权限运行程序

有时候我们的程序需要访问硬件资源,这一般需要 root 权限,而 VSCode 一般是在用户权限下启动的,这就需要特殊配置 VSCode 才能调试程序。

下面介绍如何利用 VSCode 以 root 权限调试程序。

首先需要注意到 launch.json 文件里的 "miDebuggerPath" 这个选项,它是调试器的路径,如果这个调试器可以以 root 权限运行,那么就达成了我们的目的了。

/home/user_name 目录下创建文件 gdb,user_name 需要替换为实际的用户名。

然后编辑该文件 vim gdb,加入下述内容:

sudo /usr/bin/gdb "$@"

给 gdb 添加执行权限,

chmod +x gdb

在修改 "miDebuggerPath" 成为

{
    "miDebuggerPath": "/home/jackis/gdb"
}

即可。这样我们就可以在 VSCode 里以 root 权限调试程序了,只不过每次都需要输入密码,因为有一个 sudo 过程。

为了解决这个麻烦,我又在网上找到了方法,将 /home/user_name/gdb 加入 sudo 的免密认证即可。

输入

sudo cp /etc/sudoers ~/sudoers.bak
sudo visudo

编辑 /etc/sudoers 文件,修改成下述内容即可,

其中 jackis 是我的用户名,需要根据实际用户名替换。

NOPASSWD:后的命令 sudo 时都不需要密码。退出 Shell,再重新打开一个命令行界面,输入 sudo apt update,会发现没有提示输入密码了。

  • 2
    点赞
  • 13
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值