
编程基础入门 / 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,在它的终端里依次执行:
pacman -Syu如果更新提示关闭终端,按提示关闭,再重新打开 UCRT64,继续执行 pacman -Syu,直到更新完成。然后安装编译与调试工具:
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 或命令提示符,逐行检查:
gcc --versiong++ --versiongdb --versionwhere.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;}选择“终端 → 新建终端”,确认终端所在目录就是项目目录。先编译,再单独运行:
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 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 -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:
- 点击
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", "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 的步骤按官方文档核对,尚未进行原生系统实测。
MatchAll · 编程基础入门
从一个能运行、能输入、能调试的小程序开始。