VSCode+Linux+GCC编译运行数据结构的C语言程序集

背景

学习数据结构，写了很多C语言程序，这些C语言程序都保存在一个Git仓库中，以章节、实验内容为目录存放，形如：

之前一直是通过gcc命令手动编译、运行，但随着程序逐渐复杂，希望简化构建过程，做到一键编译运行，同时支持断点调试。

环境

• VSCode，安装了C/C++扩展
• Linux
• GCC

解决方案

思路：设立一个build目录专门用来编译、运行、调试单个C语言程序，即“当前C语言程序”。通过符号链接将指定的C语言程序目录设为build目录。

1. 在~/bin目录中创建Bash脚本set-data-structure-build-dir，实现将当前目录设为build目录：

   # 构建目录的路径
   build_dir="<Git仓库>/build"
   # 删除现有的符号链接
   rm -f $build_dir
   # 将当前目录做符号链接到构建目录
   # 当前目录路径中包含空格，所以要用双引号包裹
   ln -s "$(pwd)" $build_dir
   

   给脚本添加执行权限：

   chmod +x set-data-structure-build-dir
   

   因为~/bin在环境变量PATH中，所以可以全局执行此脚本。
2. 编辑.gitignore，让Git忽略build目录：

   # 注意：因为build是符号链接，所以尾部不要加/
   build
   

3. 在.vscode目录中创建tasks.json和launch.json，让VSCode在build目录中编译、调试运行C语言程序。
   tasks.json：

   {
   	"tasks": [
   		{
   			"type": "cppbuild",
   			"label": "GCC编译",
   			"command": "/usr/bin/gcc",
   			"args": [
   				"-fdiagnostics-color=always",
   				"-g",
   				// 支持多个源文件
   				"<Git仓库>/build/*.c",
   				"-o",
   				"<Git仓库>/build/a.out"
   			],
   			"options": {
   				"cwd": "<Git仓库>/build"
   			},
   			"problemMatcher": [
   				"$gcc"
   			],
   			"group": {
   				"kind": "build",
   				"isDefault": true
   			},
   			"detail": "GCC编译"
   		}
   	],
   	"version": "2.0.0"
   }
   

   launch.json：

   {
   	"version": "0.2.0",
   	"configurations": [
   		{
   			"name": "GDB调试",
   			"type": "cppdbg",
   			"request": "launch",
   			"program": "<Git仓库>/build/a.out",
   			"args": [],
   			"stopAtEntry": false,
   			"cwd": "<Git仓库>/build",
   			"environment": [],
   			"externalConsole": false,
   			"MIMode": "gdb",
   			"setupCommands": [
   				{
   					"description": "Enable pretty-printing for gdb",
   					"text": "-enable-pretty-printing",
   					"ignoreFailures": true
   				},
   				{
   					"description": "Set Disassembly Flavor to Intel",
   					"text": "-gdb-set disassembly-flavor intel",
   					"ignoreFailures": true
   				}
   			],
   			"preLaunchTask": "GCC编译",
   			"miDebuggerPath": "/usr/bin/gdb"
   		}
   	]
   }
   

结果

在VSCode中，右键任何一个C语言程序的目录，在终端打开，然后执行set-data-structure-build-dir。

按F5编译、运行。

实测发现，即使是在原始的C语言程序目录而不是build目录中对源文件打断点，调试器也能正确在断点停住。