2669 字
13 分钟
VS Code 配置 C/C++:Linux 从安装到断点调试

编程基础入门 / VS Code C/C++ 系列 · 03

Ubuntu / Debian 主线 · GCC · GDB

装好了 VS Code,也装了 C/C++ 插件,为什么代码还是跑不起来?关键是把几件事接起来:编辑代码、编译出程序、运行程序,以及让调试器停在指定的一行。

本篇目标 输入 3 5,得到 sum = 8;再让程序停在求和语句,亲眼看到变量如何变化。

全文按“安装工具 → 编译运行 → F5 调试 → Runner → 排错”展开。先完成主线,再按需要调整快捷运行。

01 / 先认清四个角色#

VS Code 用来编辑文件。C/C++ 扩展提供补全、错误提示和相关命令。编译器把 .c 或 .cpp 变成可执行程序。调试器让你逐行执行并观察变量。

Code Runner 则负责替你执行运行命令。安装它之后,编译器仍然需要单独准备。它的 Run Code 和 F5 断点调试,也走不同的配置。

02 / 准备 Linux 工具链#

Linux 发行版的包管理器不同。本篇以 Ubuntu / Debian 的本地图形桌面环境为主线,编译器是 GCC,调试器是 GDB。WSL、容器和远程 SSH 中的扩展及工具需要安装在对应环境内,不能直接等同于本机桌面配置。

安装 VS Code 与 C/C++ 扩展#

从 VS Code 官方 Linux 安装说明 选择与你发行版和 CPU 架构相符的安装方式。Ubuntu/Debian 一般使用 .deb 包。

打开扩展视图,安装 Microsoft 发布的 C/C++,ID 为 ms-vscode.cpptools。Code Runner 在后文配置,CMake Tools 留到多文件项目阶段。

安装 GCC 与 GDB#

在系统终端中执行:

Terminal window
sudo apt update
sudo apt install build-essential gdb

输入 sudo 密码时,终端通常不会显示星号或字符;输入完成后按回车即可。随后检查:

Terminal window
gcc --version
g++ --version
gdb --version
command -v gcc
command -v g++
command -v gdb

应看到版本及对应命令路径。本篇示例配置使用 /usr/bin/gcc、/usr/bin/g++、/usr/bin/gdb;如果你的工具来自其他位置,配置也要跟着调整。VS Code 的 Linux 工具链说明

Fedora、Arch 等发行版需要使用各自的包管理器安装 GCC、C++ 编译器和 GDB,不能直接执行 apt 命令。后文的源码与编译原理仍然适用。

打开项目目录#

Terminal window
mkdir -p ~/code/cpp-start
cd ~/code/cpp-start

在 VS Code 中选择“文件 → 打开文件夹”,打开这个目录。终端中能使用 code 时,也可以执行 code .。

03 / 跑通第一个 C++ 程序#

在 VS Code 中选择“文件 → 打开文件夹”,打开刚才创建的项目目录。左侧新建 main.cpp,粘贴以下内容,然后保存。

#include <iostream>
int main() {
int a = 0;
int b = 0;
std::cout << "Enter two integers: ";
if (!(std::cin >> a >> b)) {
std::cerr << "Invalid input\n";
return 1;
}
int sum = a + b;
std::cout << "sum = " << sum << '\n';
return 0;
}

选择“终端 → 新建终端”,确认终端所在目录就是项目目录。先编译,再单独运行:

Terminal window
g++ -std=c++17 -Wall -Wextra -g -O0 main.cpp -o hello-cpp
./hello-cpp

程序显示 Enter two integers: 后,点击终端,输入 3 5,按回车。正常结果是:

Enter two integers: 3 5
sum = 8

编译成功时通常没有输出;出现错误时先修复报错,再执行运行命令,避免看到上一次编译的旧程序。

-std=c++17 选择语言标准,-Wall -Wextra 打开常用警告,-g 加入调试信息,-O0 关闭优化,便于入门阶段观察执行过程。

也学 C?再新建 hello.c#

下面是真正按 C 语言编译的版本,不需要把文件改成 .cpp:

#include <stdio.h>
int main(void) {
int a = 0;
int b = 0;
printf("Enter two integers: ");
if (scanf("%d %d", &a, &b) != 2) {
fprintf(stderr, "Invalid input\n");
return 1;
}
int sum = a + b;
printf("sum = %d\n", sum);
return 0;
}
Terminal window
gcc -std=c17 -Wall -Wextra -g -O0 hello.c -o hello-c
./hello-c

同样输入 3 5,应得到 sum = 8。C 文件用 C 编译器;C++ 文件用 C++ 编译器,避免后续遇到标准库链接问题。

04 / 按 F5,真正进入调试#

项目里新建 .vscode 文件夹。下面两份配置固定构建 main.cpp,即使当前打开的是 JSON 文件,也不会误把配置文件当源码编译。

先保存为 .vscode/tasks.json:

{
"version": "2.0.0",
"tasks": [
{
"label": "build C++",
"type": "process",
"command": "/usr/bin/g++",
"args": [
"-std=c++17",
"-Wall",
"-Wextra",
"-g",
"-O0",
"main.cpp",
"-o",
"hello-cpp"
],
"options": {
"cwd": "${workspaceFolder}"
},
"problemMatcher": [
"$gcc"
],
"group": {
"kind": "build",
"isDefault": true
}
}
]
}

再保存为 .vscode/launch.json:

{
"version": "0.2.0",
"configurations": [
{
"name": "Debug C++",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/hello-cpp",
"args": [],
"cwd": "${workspaceFolder}",
"preLaunchTask": "build C++",
"stopAtEntry": false,
"externalConsole": false,
"MIMode": "gdb",
"miDebuggerPath": "/usr/bin/gdb"
}
]
}

preLaunchTask 和编译任务的 label 必须完全一致。program 是编译生成的可执行文件,而不是 .cpp 源码。

现在回到 main.cpp:

  1. 点击 int sum = a + b; 左侧行号旁的空白,出现红点即设好了断点。
  2. 保存文件,按 F5;若键盘把 F 键用作媒体键,按 Fn + F5。
  3. 在“运行和调试”中选择 Debug C++。首次弹出工具链信任提示时,确认路径属于自己安装的编译器。
  4. 在终端输入 3 5,按回车,程序应停在求和行。
  5. 查看左侧“变量”中的 a、b;此时求和行尚未执行。按 F10 后,再观察 sum 变为 8。
  6. 按 F5 继续执行,按 Shift + F5 结束调试。

输入数字的位置是终端,不是“调试控制台”。要调试 C,复制上述两份配置,将构建命令改为 C 编译器(Windows 用 gcc.exe,macOS 用 clang,Linux 用 gcc)、标准改为 -std=c17、输入改为 hello.c、输出改为 hello-c(Windows 为 hello-c.exe)。同时将调试配置的 program 改为对应输出,任务 label 与 preLaunchTask 保持一致。C 与 C++ 两个练习分别构建,不要一起链接。

05 / Runner 怎么选,怎么配#

推荐 Code Runner,扩展 ID 为 formulahendry.code-runner。它适合课程练习、单文件题目和快速检查输出。需要观察变量和断点时,使用上一节的 F5。

在扩展商店搜索并安装它。然后打开命令面板,执行 Preferences: Open Workspace Settings (JSON),将以下键合并到项目的 .vscode/settings.json。

已有配置时,保留原有内容并合并键值;不要在一个 JSON 对象里重复写同一个键。

{
"code-runner.runInTerminal": true,
"code-runner.saveFileBeforeRun": true,
"code-runner.ignoreSelection": true,
"code-runner.fileDirectoryAsCwd": true,
"files.encoding": "utf8",
"code-runner.executorMap": {
"c": "cd $dirWithoutTrailingSlash && gcc -std=c17 -Wall -Wextra -g -O0 \"$fileName\" -o \"$fileNameWithoutExt\" && \"./$fileNameWithoutExt\"",
"cpp": "cd $dirWithoutTrailingSlash && g++ -std=c++17 -Wall -Wextra -g -O0 \"$fileName\" -o \"$fileNameWithoutExt\" && \"./$fileNameWithoutExt\""
}
}

以上命令适用于 macOS/Linux 常见的 zsh 或 bash。Code Runner 会自动为 $dirWithoutTrailingSlash 加引号,不要再包一层;文件名占位符两侧的引号则要保留,用来兼容空格。

回到完整的 .c 或 .cpp 文件,右键选择 Run Code;也可以在命令面板执行 Run Code。输入数据时点击下方终端。

这几个开关各有用途:

  • runInTerminal:允许 scanf、cin 读取键盘输入。
  • saveFileBeforeRun:运行前保存,避免执行旧源码。
  • ignoreSelection:始终运行整个文件,避免误执行选中的半段代码。
  • fileDirectoryAsCwd:默认以源码目录作为工作目录;如果另外设置过 code-runner.cwd,应检查它是否覆盖了这一行为。

这份 executor 每次只编译当前文件。涉及多个 .cpp、第三方库或复杂目录时,应改用明确列出源文件的构建任务,或引入 CMake。CMake Tools 可以到那时再安装。

Code Runner 的设置、tasks.json 和 launch.json 各管一部分。修改 Runner 的编译参数,不会自动修改 F5 使用的构建任务。

06 / 常见问题,按现象排查#

gcc 能运行,但 g++ / gdb 找不到#

它们是相关但不同的工具。检查 build-essential 与 gdb 的安装结果,再运行 command -v g++ 和 command -v gdb。远程窗口或容器中应检查远端环境,而不是宿主机。

Permission denied / 运行不了程序#

先确认使用的是 ./hello-cpp,而不是直接输入 hello-cpp。本篇编译器生成的程序通常已有执行权限;如果项目放在禁止执行的挂载点、共享盘或受限目录,先移到个人主目录下的项目文件夹。不要用 sudo code 来绕过问题。

cin / scanf 无法输入#

检查 Code Runner 是否运行在“输出”面板。启用 runInTerminal: true,并在终端输入。F5 调试使用 externalConsole: false,程序输入输出位于集成终端。

ptrace / Operation not permitted#

先区分“启动自己的程序”和“附加已有进程”。容器安全策略、沙箱、系统调试策略都可能影响 GDB。记录完整错误,核对当前运行环境的调试权限;不要一上来全局关闭系统安全限制,也不要把编辑器改成 root 运行。

undefined reference to std::cout#

C++ 源码应使用 g++ 链接。即使 gcc 能识别 .cpp,它也不等同于已经正确配置了 C++ 标准库链接。

main 的重复定义 / 函数找不到#

本篇的 hello.c 与 main.cpp 各自是独立程序,不要一起链接。多文件工程中,声明对应的 .cpp 实现也必须参与构建;只写 #include 并不会自动编译其他实现文件。

中文显示不正常#

将源码保存为 UTF-8,并运行 locale 检查当前终端使用的字符集。终端字体缺少字形时也会显示方框;编码错误与缺字不是同一个问题,先观察英文示例能否正常运行。

IntelliSense 报错,终端编译正常#

在 C/C++: Edit Configurations (UI) 中确认 Compiler path 指向实际的 /usr/bin/g++。IntelliSense mode 要匹配本机 CPU,例如 gcc-x64 或 gcc-arm64;它影响编辑器分析,不会替你修改真正的编译命令。

07 / 配置完成,用结果验收#

  • C++ 程序输入 3 5,得到 sum = 8。
  • C 程序也能独立编译运行,得到相同结果。
  • F5 能停在求和语句,F10 后可以观察到 sum = 8。
  • Run Code 在终端中接受输入,不会只运行选中的片段。

做到这些,说明编辑器、编译器、运行环境与调试器已经接通。下一步可以开始变量、分支、循环和函数练习。

系列导航

官方资料与工具#

资料核对日期:2026-11-13。命令与版本以各项目当前文档为准。Windows 相关示例已在本机进行命令级验证,macOS 与 Linux 的步骤按官方文档核对,尚未进行原生系统实测。

VS Code / GCC on Linux

VS Code / Linux 安装

Code Runner 设置说明

doocs/md 排版工具


MatchAll · 编程基础入门

从一个能运行、能输入、能调试的小程序开始。

VS Code 配置 C/C++:Linux 从安装到断点调试
https://blog.maximoraverse.org/posts/vscode-c-cpp-linux/
作者
MatchAll
发布于
2026-11-13
许可协议
CC BY-NC-SA 4.0