
编程基础入门 / 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
在系统终端中执行:
sudo apt updatesudo apt install build-essential gdb输入 sudo 密码时,终端通常不会显示星号或字符;输入完成后按回车即可。随后检查:
gcc --versiong++ --versiongdb --versioncommand -v gcccommand -v g++command -v gdb应看到版本及对应命令路径。本篇示例配置使用 /usr/bin/gcc、/usr/bin/g++、/usr/bin/gdb;如果你的工具来自其他位置,配置也要跟着调整。VS Code 的 Linux 工具链说明
Fedora、Arch 等发行版需要使用各自的包管理器安装 GCC、C++ 编译器和 GDB,不能直接执行 apt 命令。后文的源码与编译原理仍然适用。
打开项目目录
mkdir -p ~/code/cpp-startcd ~/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;}选择“终端 → 新建终端”,确认终端所在目录就是项目目录。先编译,再单独运行:
g++ -std=c++17 -Wall -Wextra -g -O0 main.cpp -o hello-cpp./hello-cpp程序显示 Enter two integers: 后,点击终端,输入 3 5,按回车。正常结果是:
Enter two integers: 3 5sum = 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;}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:
- 点击
int sum = a + b;左侧行号旁的空白,出现红点即设好了断点。 - 保存文件,按 F5;若键盘把 F 键用作媒体键,按 Fn + F5。
- 在“运行和调试”中选择
Debug C++。首次弹出工具链信任提示时,确认路径属于自己安装的编译器。 - 在终端输入
3 5,按回车,程序应停在求和行。 - 查看左侧“变量”中的
a、b;此时求和行尚未执行。按 F10 后,再观察sum变为8。 - 按 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 的步骤按官方文档核对,尚未进行原生系统实测。
MatchAll · 编程基础入门
从一个能运行、能输入、能调试的小程序开始。