2931 字
15 分钟
VS Code 配置 C/C++:Windows 从安装到断点调试

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

Windows 10/11 x64 · MSYS2 UCRT64 · 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 / 准备 Windows 工具链#

本篇主线适用于 Windows 10/11 的 Intel/AMD 64 位电脑,安装在默认目录 C:\msys64。Windows on ARM 使用不同的原生工具链,不能直接照搬本文的 UCRT64 路径。

安装 VS Code 与扩展#

从 VS Code 官网 下载对应系统的安装包。打开扩展视图,搜索 C/C++,确认发布者为 Microsoft,扩展 ID 为 ms-vscode.cpptools。

希望使用中文界面,可再安装 Microsoft 的 Chinese (Simplified) Language Pack。Code Runner 在后文单独配置。

安装 MSYS2,选择 UCRT64#

从 MSYS2 官网 安装 x86_64 版本,建议保留默认位置。开始菜单打开 MSYS2 UCRT64,在它的终端里依次执行:

Terminal window
pacman -Syu

如果更新提示关闭终端,按提示关闭,再重新打开 UCRT64,继续执行 pacman -Syu,直到更新完成。然后安装编译与调试工具:

Terminal window
pacman -S --needed base-devel mingw-w64-ucrt-x86_64-toolchain

选择工具组成员时按回车接受默认全部,确认安装时输入 Y。pacman 在 MSYS2 终端执行;它不是 PowerShell 内置命令。

路径要保持一致 本文使用 UCRT64:安装包名包含 ucrt,路径包含 ucrt64。不要混用旧教程里的 mingw64 路径,也不要把 C:\msys64\usr\bin 当作这里的编译器路径。MSYS2 当前也推荐不确定时选择 UCRT64。环境说明

配好用户 Path#

Windows 搜索“编辑账户的环境变量”,在用户变量中找到 Path,点“编辑 → 新建”,加入:

C:\msys64\ucrt64\bin

保留原有条目,不要覆盖整个 Path。确定保存后,彻底退出 VS Code,再重新启动。

新开 PowerShell 或命令提示符,逐行检查:

Terminal window
gcc --version
g++ --version
gdb --version
where.exe g++

前三条应显示版本;最后一条应能找到 C:\msys64\ucrt64\bin\g++.exe。有多个结果时,留意旧版 MinGW 是否排在前面。

最后创建 C:\code\cpp-start,作为本篇项目目录。先用简单英文目录跑通流程,后续再处理更复杂的路径。

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 -finput-charset=UTF-8 -fexec-charset=UTF-8 main.cpp -o hello-cpp.exe
.\hello-cpp.exe

程序显示 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 -finput-charset=UTF-8 -fexec-charset=UTF-8 hello.c -o hello-c.exe
.\hello-c.exe

同样输入 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": "C:/msys64/ucrt64/bin/g++.exe",
"args": [
"-std=c++17",
"-Wall",
"-Wextra",
"-g",
"-O0",
"-finput-charset=UTF-8",
"-fexec-charset=UTF-8",
"main.cpp",
"-o",
"hello-cpp.exe"
],
"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.exe",
"args": [],
"cwd": "${workspaceFolder}",
"preLaunchTask": "build C++",
"stopAtEntry": false,
"externalConsole": false,
"MIMode": "gdb",
"miDebuggerPath": "C:/msys64/ucrt64/bin/gdb.exe",
"environment": [
{
"name": "PATH",
"value": "C:\\msys64\\ucrt64\\bin;${env:PATH}"
}
]
}
]
}

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",
"terminal.integrated.defaultProfile.windows": "Command Prompt",
"code-runner.executorMap": {
"c": "cd /d $dirWithoutTrailingSlash && chcp 65001 >nul && gcc -std=c17 -Wall -Wextra -g -O0 -finput-charset=UTF-8 -fexec-charset=UTF-8 \"$fileName\" -o \"$fileNameWithoutExt.exe\" && \".\\$fileNameWithoutExt.exe\"",
"cpp": "cd /d $dirWithoutTrailingSlash && chcp 65001 >nul && g++ -std=c++17 -Wall -Wextra -g -O0 -finput-charset=UTF-8 -fexec-charset=UTF-8 \"$fileName\" -o \"$fileNameWithoutExt.exe\" && \".\\$fileNameWithoutExt.exe\""
}
}

这套 Runner 配置使用 Command Prompt(cmd)。 保存后关闭已有终端,再新建终端,或执行 Terminal: Select Default Profile 选择 Command Prompt。命令中的 cd /d 属于 cmd 语法,不能直接拿到 PowerShell 里执行。

如果你偏好 PowerShell 7,可以另外编写适配 PowerShell 的 executor;不要只换终端而保留 cmd 命令。Windows PowerShell 5.1 还不支持 &&。

回到完整的 .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#

先检查工具是否真的装在 C:\msys64\ucrt64\bin。重新打开 VS Code 后再运行 where.exe g++。仅安装 C/C++ 扩展不会提供编译器;仅加入 Path,也不会自动下载工具。

“&& 在此版本中不是有效的语句分隔符”#

通常是 Windows PowerShell 5.1 正在执行为 cmd 或 PowerShell 7 编写的命令。本篇 Runner 使用 cmd,先检查终端右上角显示的名称,并重新创建终端。

scanf / cin 输入不了,程序像卡住一样#

检查是否在“输出”面板运行。设置 runInTerminal: true 后重开终端,并点击终端输入。程序等待输入时不会自动结束;不要连续点击 Run Code 启动多份程序。

中文乱码,或中文文件名编译异常#

文件编码、编译器处理字符串的编码、终端编码要互相匹配。本篇使用 UTF-8 文件、UTF-8 编译参数,以及 Runner 中的 chcp 65001。如果手动运行中文输出示例,可先在当前终端执行 chcp 65001。

这些设置不能修复所有 Unicode 路径问题。源码、链接器输出文件名和终端显示是不同环节。先用英文目录和英文文件名复现,确认基础链路,再单独定位中文路径;不要因为乱码就重装所有软件。

cannot open output file / Permission denied#

上一次运行的程序可能还在等待输入,占用了 .exe。在终端按 Ctrl+C,或停止调试后再编译。不要同时启动多个 Runner 去写同一个输出文件。

缺少 libstdc++ 或 libgcc DLL#

确认运行程序的终端也能找到 UCRT64 的 bin 目录。不要从不明网站单独下载 DLL。本篇 F5 配置显式加入了工具链 Path;直接把 exe 拷给另一台电脑,需要另外处理运行库分发。

红色波浪线,但终端可以编译#

从命令面板打开 C/C++: Edit Configurations (UI),将 Compiler path 设为 C:/msys64/ucrt64/bin/g++.exe,IntelliSense mode 设为 windows-gcc-x64,C 标准设为 C17、C++ 标准设为 C++17。不要随意把所有系统头文件目录逐项塞进 includePath。

出现多个 main / undefined reference#

main.cpp 和 hello.c 是两个独立练习,各有入口。不要把它们一起链接为一个程序。真正的多文件项目应只有一个 main,并把需要的实现文件全部纳入构建。

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

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

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

系列导航

官方资料与工具#

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

VS Code / GCC on Windows

MSYS2 安装与环境选择

MSYS2 更新

Code Runner 设置说明

doocs/md 排版工具


MatchAll · 编程基础入门

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

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