「编程实践录」致力于分享开发技术实践经验，欢迎您关注，我们共同交流进步。
点击此链接可进入编程实践录主页
本文以C++为例，讲解了VS Code中.vscode文件夹下的核心配置。tasks.json文件用于定义编译等外部命令任务，而launch.json则负责配置程序的运行、调试与内存分析等。通过联动这两个文件，可以实现从编译到运行调试的自动化流程，打造高效的开发利器。
之前我们已经陆续介绍了如何利用 VS Code 和 Remote-SSH 插件搭建远程开发环境，并分别探讨了如何在该环境下进行 Python 和 C++ 的编码开发。最近，有许多朋友对项目中 .vscode 文件夹下的几个 JSON 文件感到好奇，有时遇到编译或调试问题，也往往与这几个文件的配置有关。
正所谓“工欲善其事，必先利其器”。仅仅会使用图形化界面点击编译和运行是不够的，知其所以然，才能真正将 `VS Code`` 打造成符合我们个人需求的开发利器。
今天，我们就来深入解析一下 VS Code 工作区中最核心的几个 JSON 配置文件，并以我们熟悉的 C++ 开发为例，详细讲解 tasks.json和launch.json 的配置与使用。
一、VS Code 中的核心 JSON 配置文件概览
当你在 VS Code 中打开一个项目文件夹，并开始进行编译、调试等配置时，VS Code 会自动在你的项目根目录下创建一个名为 .vscode 的隐藏文件夹。这个文件夹存放了所有与该项目（工作区）相关的特定配置，从而实现了配置的隔离，避免了全局配置的混乱。
其中，最重要的几个 JSON 文件包括：
-
settings.json：工作区设置。这里定义的设置会覆盖你的用户全局设置。例如，你可以为这个特定的项目设置不同的字体大小、缩进风格，或者指定特定的代码格式化工具。 -
tasks.json：任务配置文件。该文件用于定义和配置任务（Task）。“任务”在 VS Code 中是一个宽泛的概念，通常指代任何你希望执行的外部命令，最典型的应用就是编译代码、运行脚本、打包程序等。 -
launch.json：启动配置文件。该文件专门用于配置和管理“启动”或“调试”会话。它告诉 VS Code 如何运行你的程序，以及如何将调试器附加到该程序上。 -
c_cpp_properties.json：C/C++ 扩展专属配置文件。如果你安装了 Microsoft 的 C/C++ 扩展，这个文件用于帮助 IntelliSense（智能提示、代码补全等）理解你的代码结构，比如指定头文件的包含路径、编译器路径、C++ 标准版本等。
今天我们的主角，是 tasks.json 和 launch.json。它们俩一个负责“编译”，一个负责“运行和调试”，是 C++ 开发工作流中承上启下的关键环节。
二、准备一个 C++ 示例代码
在我们深入 tasks.json 和 launch.json 的配置细节之前，先准备一份用于测试的 C++ 源代码。这份代码功能简单，但特意设计了一些特点，以便我们后续能完整地演示编译、运行、调试和内存分析。
请在你的项目文件夹下创建 main.cpp 文件，并填入以下内容：
// main.cpp
#include <iostream>
#include <vector>
void perform_calculation() {
int sum = 0;
for (int i = 1; i <= 10; ++i) {
sum += i;
}
std::cout << "The sum from 1 to 10 is: " << sum << std::endl;
// 为了演示 Valgrind，这里我们故意制造一个内存泄漏
// We are intentionally creating a memory leak here to demonstrate Valgrind.
int* leaky_pointer = new int(42);
// 注意：我们没有调用 delete leaky_pointer;
// Note: We are not calling delete leaky_pointer;
}
int main() {
std::cout << "Starting the program..." << std::endl;
perform_calculation();
std::cout << "Program finished." << std::endl;
return 0;
}
代码解读：
- 程序的主体功能是计算 1 到 10 的和并打印结果。这可以帮助我们验证程序的基本运行。
-
for循环结构和sum变量的存在，为我们提供了设置断点、单步跟踪和观察变量值的良好场景。 - 最关键的一点是
int* leaky_pointer = new int(42);这行代码。我们用new关键字在堆上分配了一块内存，但在函数结束时并没有使用delete来释放它。这是一个典型的内存泄漏案例，后续我们可以用 Valgrind 工具来检测它。
现在，我们有了“靶子”，接下来就可以配置我们的“弓箭”——tasks.json 和 launch.json 了。
三、实战阶段
tasks.json：定义你的编译任务
tasks.json 的核心作用，就是将你在终端中手动输入的编译命令，封装成一个个可以在 VS Code 中通过菜单或快捷键触发的“任务”。
让我们以一个简单的 C++ 项目为例，假设项目结构如下：
my_project/
├── .vscode/
│ └── tasks.json
└── main.cpp
我们的目标是为 main.cpp 创建两种编译任务：
- Debug (调试) 模式：包含调试信息，不进行代码优化，方便 GDB 等调试器逐行跟踪。
- Release (发布) 模式：开启编译器优化，去除调试信息，生成运行速度更快、体积更小的可执行文件。
下面是一个完整的 tasks.json 示例：
// .vscode/tasks.json
{
"version": "2.0.0",
"tasks": [
{
"label": "build: debug",
"type": "shell",
"***mand": "g++",
"args": [
"-g",
"-Wall",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}.debug"
],
"group": {
"kind": "build",
"isDefault": true
},
"problemMatcher": [
"$g***"
],
"detail": "使用 G++ 编译 C++ 文件 (调试模式)"
},
{
"label": "build: release",
"type": "shell",
"***mand": "g++",
"args": [
"-O2",
"-Wall",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}.release"
],
"group": "build",
"problemMatcher": [
"$g***"
],
"detail": "使用 G++ 编译 C++ 文件 (发布模式)"
}
]
}
我们来逐一解析这个文件中的关键字段：
-
"version": "2.0.0"：这是 tasks.json 的 schema 版本，目前固定写2.0.0即可。 -
"tasks": [...]：一个数组，其中每一项都是一个独立的任务对象。 -
"label"：任务的名称，例如"build: debug"。这个名称会显示在 VS Code 的命令面板中，方便我们识别和选择。 -
"type": "shell"：任务的类型。"shell"表示这个任务将在系统的默认 shell 环境中执行一条命令，通用性很强。 -
"***mand": "g++"：要执行的命令。这里是我们的 C++ 编译器g++。 -
"args": [...]：传递给***mand的参数列表，这是一个字符串数组。-
-g：告诉 g++ 生成调试信息。 -
-O2：告诉 g++ 进行二级优化。 -
-Wall：开启所有常用警告。 -
${file}：这是一个 VS Code 预定义变量，代表当前活动窗口中打开的文件的完整路径。 -
-o：指定输出文件的路径。 -
${fileDirname}/${fileBasenameNoExtension}.debug：这是另一个巧妙的组合。${fileDirname}是当前文件所在的目录，${fileBasenameNoExtension}是当前文件的文件名（不含扩展名）。我们通过添加.debug和.release后缀来区分不同模式下生成的可执行文件，这是一个非常好的工程习惯。
-
-
"group"：任务分组。-
"kind": "build"：将此任务标记为一个“构建”任务。 -
"isDefault": true：将这个任务（build: debug）设置为默认的构建任务。这样，当我们按下快捷键Ctrl+Shift+B时，就会直接执行这个任务。
-
-
"problemMatcher": ["$g***"]：问题匹配器。这是非常实用的一个功能！它能够解析g++编译时输出的错误和警告信息，并将其直接关联到源代码中对应的行，你可以在“问题”面板看到它们，并且点击即可跳转，极大提高了排错效率。
配置好这个 tasks.json 后，打开 main.cpp，按下 Ctrl+Shift+B，VS Code 就会自动执行 build: debug 任务，在当前目录下生成一个名为 main.debug 的可执行文件。你也可以通过 Ctrl+Shift+P 打开命令面板，输入 Tasks: Run Task 来选择并运行我们定义的任一任务。
此处提示变量 leaky_pointer 未被使用的警告是预期情况。该变量是专为特定测试场景而声明的，因此这条警告可以安全地忽略。
launch.json：运行、调试与分析
编译完成后，下一步就是运行和调试了。这正是 launch.json 的用武之地。它定义了 VS Code 调试面板（侧边栏的小虫子图标）中下拉菜单里的所有选项。
继续我们的 C++ 例子，我们希望实现以下三种启动方式：
- 运行 (Release)：直接运行经过优化的 Release 版本程序，查看其最终运行效果。
- 调试 (Debug)：启动 GDB 调试器来运行 Debug 版本的程序，支持断点、单步执行、查看变量等。
- 内存分析 (Valgrind)：使用 Valgrind 工具来运行 Debug 版本的程序，检查内存泄漏等问题。
下面是相应的 launch.json 完整配置：
// .vscode/launch.json
{
"version": "0.2.0",
"configurations": [
{
"name": "Run C++ (Release)",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}.release",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "gdb",
"preLaunchTask": "build: release",
"internalConsoleOptions": "neverOpen"
},
{
"name": "Debug C++ (gdb)",
"type": "cppdbg",
"request": "launch",
"program": "${fileDirname}/${fileBasenameNoExtension}.debug",
"args": [],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "gdb",
"setup***mands": [
{
"description": "为 gdb 启用整齐打印",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
],
"preLaunchTask": "build: debug"
},
{
"name": "Memory Check (Valgrind)",
"type": "cppdbg",
"request": "launch",
"program": "/usr/bin/valgrind",
"args": [
"--leak-check=full",
"--show-leak-kinds=all",
"--track-origins=yes",
"${fileDirname}/${fileBasenameNoExtension}.debug"
],
"stopAtEntry": false,
"cwd": "${fileDirname}",
"environment": [],
"externalConsole": false,
"MIMode": "gdb",
"preLaunchTask": "build: debug"
}
]
}
解析一下这里的关键字段：
-
"configurations": [...]：一个数组，包含了多个启动配置项。 -
"name"：配置项的名称，会显示在调试面板的下拉菜单中。 -
"type": "cppdbg"：调试器的类型。cppdbg是 C/C++ 扩展提供的调试器。 -
"request": "launch"：请求类型。"launch"表示由 VS Code 启动一个新进程并附加调试器。 -
"program"：要执行的程序的绝对路径。- 在调试配置中，我们指向
.debug后缀的文件。 - 在 Valgrind 配置中，我们直接启动
valgrind程序本身，然后把我们的目标程序作为参数传给它。
- 在调试配置中，我们指向
-
"args": [...]：传递给你自己程序的命令行参数。 -
"cwd": "${fileDirname}"：指定程序运行时的当前工作目录。 -
"preLaunchTask"：这是连接tasks.json和launch.json的桥梁！ 它指定在启动此调试会话之前需要执行的一个任务（其label必须与tasks.json中定义的任务匹配）。- 例如，在
"Debug C++ (gdb)"配置中，我们设置"preLaunchTask": "build: debug"。这意味着每次我们点击“调试”时，VS Code 会先自动执行build: debug任务，确保我们正在调试的是最新版本的代码。这是一个极其重要的自动化流程。
- 例如，在
-
"MIMode": "gdb"：指定调试器接口模式，对于 Linux 环境下的 C++ 开发，通常是gdb。 -
"setup***mands"：在启动调试后，自动发送给调试器的一些初始化命令，例如启用 GDB 的 pretty-printing 功能，让 STL 容器等显示更友好。
配置完成后，切换到 VS Code 的“运行和调试”侧边栏，你就能在顶部的下拉菜单中看到我们刚刚定义的三种模式了：“Run C++ (Release)”, “Debug C++ (gdb)”, “Memory Check (Valgrind)”。选择任何一个，点击绿色的“启动”按钮（或按 F5），VS Code 就会执行 preLaunchTask（如果已配置），然后启动你的程序。
运行效果示例
当我们完成了上述所有配置后，就可以在“运行和调试”侧边栏中选择不同的模式来启动程序了。下面是各个模式预期的输出结果，你可以用它来检验自己的配置是否正确。
输出内容通常会显示在 VS Code 下方的“终端”或“调试控制台”面板中。
1. 运行 “Run C++ (Release)”
选择此模式并点击启动后，VS Code 会先执行 build: release 任务编译代码，然后直接运行生成的 main.release 程序。你会在**“终端”**面板看到类似如下的干净输出：
Starting the program...
The sum from 1 to 10 is: 55
Program finished.
这表明我们的程序在 Release 模式下逻辑正确，并成功运行。
2. 运行 “Debug C++ (gdb)”
选择此模式并启动后（假设你在 sum += i; 这一行设置了断点），程序会先编译，然后在断点处暂停。此时，整个 VS Code 将进入调试视图。程序的输出会显示在**“调试控制台”**面板中，并且通常会伴有一些调试器的信息。
3. 运行 “Memory Check (Valgrind)”
这是最能体现我们配置价值的地方。选择此模式并启动，程序会正常运行并输出结果，但在程序结束后，Valgrind 会接管并打印出它的内存分析报告。你同样会在**“调试控制台”**面板看到这份报告，其核心部分如下所示：
... (程序自己的输出)
Starting the program...
The sum from 1 to 10 is: 55
Program finished.
... (Valgrind 的其他信息)
==893653== LEAK SUMMARY:
==893653== definitely lost: 4 bytes in 1 blocks
==893653== indirectly lost: 0 bytes in 0 blocks
==893653== possibly lost: 0 bytes in 0 blocks
==893653== still reachable: 0 bytes in 0 blocks
==893653== suppressed: 0 bytes in 0 blocks
==893653==
==893653== For counts of detected and suppressed errors, rerun with: -v
==893653== ERROR SUMMARY: 1 errors from 1 contexts (suppressed: 0 from 0)
报告解读：
-
LEAK SUMMARY:(泄漏总结) 是我们需要关注的核心。 -
definitely lost: 4 bytes in 1 blocks这一行明确地告诉我们：有 4 个字节的内存（正好是一个int的大小）在 1 个内存块中被“确定无疑地”泄漏了。 - Valgrind 还提供了更详细的堆栈跟踪信息，指出泄漏发生在
main.cpp的第15行，帮助我们快速定位到了main.cpp中new int(42);的位置。
这个结果证明了我们的内存分析配置成功生效，并准确地捕获到了我们故意制造的内存泄漏问题。
通过以上三个示例，我们不仅验证了配置的正确性，也完整体验了 VS Code 从编译构建、运行验证、深入调试到专业内存分析的 C++ 全流程开发闭环。
四、 总结
通过对 tasks.json 和 launch.json 的学习，我们打通了在 VS Code 中进行 C++ 开发的“任督二脉”：
-
tasks.json负责编译，将复杂的命令行封装为简单的、可复用的任务，并能智能解析编译错误。 -
launch.json负责运行与调试，定义了多样化的程序启动方式，并能与tasks.json联动，实现“一键编译并调试”的流畅体验。
这种基于 JSON 的声明式配置，虽然初看有些复杂，但一旦掌握，其灵活性和可扩展性远超传统的 IDE。你可以自由地集成任何命令行工具到你的开发流程中，无论是代码检查、性能分析还是自动化部署，都可以通过配置 tasks.json 和 launch.json 来实现。
希望这篇文章能帮助大家更好地理解和运用 VS Code。请务必亲手尝试一下文中的示例，在自己的项目中进行配置。只有实践，才能将知识真正转化为能力。
感谢大家的阅读，希望本文对您有所帮助。如果您认为内容有价值，欢迎关注与分享。
写在最后
大家好，这里是[编程实践录]，一个热衷于分享实用开发技巧的技术博客。
写一篇高质量文章不易，如果这篇文章确实帮助到了你，希望可以点赞、收藏、关注一下，这也是我持续创作的最大动力！
当然，我更推荐你来我的公众号【编程实践录】找我。
为什么？因为在那里，除了所有文章的首发，我还准备了：
- 深度交流：你可以随时在公众号后台向我提问，我都会逐一回复。
- 硬核干货：更多关于编程实践的独家技巧和思考。
在微信搜索框里，直接搜索“编程实践录”，就可以找到我。我们换个地方，聊点更深的！
