VS Code 配置 C/C++ 开发环境完整指南（Windows + MinGW-w64）

VS Code 配置 C/C 开发环境完整指南Windows MinGW-w64本文介绍如何在 Windows 系统上使用 MinGW-w64 VS Code 搭建完整的 C/C 开发环境涵盖安装、配置、编译、调试全流程。目录环境概览第一步安装 MinGW-w64第二步验证安装第三步安装 VS Code 扩展第四步配置 IntelliSense第五步配置编译任务第六步配置调试环境第七步使用方式常见问题环境概览项目说明操作系统Windows 10/11编辑器Visual Studio Code编译器MinGW-w64 GCC调试器GDB随 MinGW-w64 一同安装第一步安装 MinGW-w641.1 下载MinGW-w64 是 GCC 在 Windows 上的移植版本提供 C/C 编译器和调试器。快速下载前往 GitHub Release 页面下载下载地址https://github.com/niXman/mingw-builds-binaries/releases在最新版本的 Assets 中选择以下格式的文件x86_64-*-release-posix-seh-ucrt-*.7z各字段含义字段说明x86_6464 位架构绝大多数用户选这个posix线程模型推荐posixseh异常处理机制64 位推荐sehucrtC 运行时库推荐ucrt更现代如果是 32 位系统选择i686-*开头的文件。官网下载官网https://www.mingw-w64.org/1.2 解压安装MinGW-w64 是免安装的解压即用下载完成后得到一个.7z压缩包使用 7-Zip 或其他解压工具将压缩包解压到你想要安装MinGW-w64的目录推荐路径避免路径中包含中文和空格同时记住你解压的路径C:\mingw64或D:\mingw64解压后的目录结构mingw64/ ├── bin/ ← 编译器和工具的可执行文件重要 │ ├── gcc.exe │ ├── g.exe │ ├── gdb.exe │ └── ... ├── include/ ← C/C 头文件 ├── lib/ ← 库文件 ├── share/ ← 文档和共享资源 └── ...1.3 配置系统环境变量可选如果希望在任意终端中直接使用gcc、g命令需要将bin目录添加到系统PATH按Win S搜索“环境变量”点击“编辑系统环境变量”点击“环境变量”按钮在“系统变量”中找到Path双击编辑点击“新建”添加 MinGW-w64 的bin路径例如C:\mingw64\bin点击“确定”保存所有对话框重新打开一个终端窗口使环境变量生效验证环境变量是否生效gcc--versiong--versiongdb--version注意本文后续的 VS Code 配置中使用绝对路径指向编译器因此即使不配置环境变量VS Code 中的编译和调试功能也能正常工作。第二步验证安装打开终端PowerShell 或 CMD执行以下命令确认安装成功# 验证 GCCC 编译器gcc--version# 验证 GC 编译器g--version# 验证 GDB调试器gdb--version预期输出示例gcc.exe (x86_64-win32-seh-rev0, Built by MinGW-Builds project) 14.2.0 Copyright (C) 2024 Free Software Foundation, Inc. g.exe (x86_64-win32-seh-rev0, Built by MinGW-Builds project) 14.2.0 Copyright (C) 2024 Free Software Foundation, Inc. GNU gdb (GDB) 15.2 Copyright (C) 2024 Free Software Foundation, Inc.版本号可能不同只要没有报错即说明安装成功。第三步安装 VS Code 扩展打开 VS Code安装以下扩展扩展名称扩展 ID用途C/Cms-vscode.cpptoolsIntelliSense、代码导航、调试C/C Extension Packms-vscode.cpptools-extension-pack完整 C/C 开发工具包在 VS Code 中按CtrlShiftX打开扩展面板搜索并安装。或使用命令行安装code --install-extension ms-vscode.cpptools-extension-pack第四步配置 IntelliSense在项目根目录下创建.vscode文件夹然后创建c_cpp_properties.json文件。文件路径.vscode/c_cpp_properties.json{configurations:[{name:Win32,includePath:[${workspaceFolder}/**],defines:[_DEBUG,UNICODE,_UNICODE],compilerPath:C:/mingw64/bin/gcc.exe,cStandard:c17,cppStandard:c17,intelliSenseMode:windows-gcc-x64}],version:4}需要修改的地方将compilerPath改为你本机 MinGW-w64 的gcc.exe实际路径注意使用正斜杠/。配置项说明字段说明includePath头文件搜索路径${workspaceFolder}/**表示递归搜索整个项目目录defines预处理宏定义_DEBUG用于调试模式UNICODE/_UNICODE启用 Unicode 支持compilerPathGCC 编译器的绝对路径IntelliSense 用它来查找系统头文件cStandardC 语言标准版本可选c11、c17、c23cppStandardC 标准版本可选c11、c14、c17、c20、c23intelliSenseModeIntelliSense 解析模式64 位 MinGW-w64 用windows-gcc-x6432 位用windows-gcc-x86第五步配置编译任务创建tasks.json文件定义编译快捷键。文件路径.vscode/tasks.json{version:2.0.0,tasks:[{label:C/C: gcc.exe 生成活动文件,type:cppbuild,command:C:/mingw64/bin/gcc.exe,args:[-fdiagnostics-coloralways,-g,-Wall,-Wextra,-o,${fileDirname}/${fileBasenameNoExtension}.exe,${file}],options:{cwd:${fileDirname}},problemMatcher:[$gcc],group:{kind:build,isDefault:true},detail:编译器: C:/mingw64/bin/gcc.exe},{label:C/C: g.exe 生成活动文件,type:cppbuild,command:C:/mingw64/bin/g.exe,args:[-fdiagnostics-coloralways,-g,-Wall,-Wextra,-o,${fileDirname}/${fileBasenameNoExtension}.exe,${file}],options:{cwd:${fileDirname}},problemMatcher:[$gcc],group:build,detail:编译器: C:/mingw64/bin/g.exe}]}需要修改的地方将两个任务的command字段改为你本机的gcc.exe和g.exe实际路径。编译参数说明参数说明-fdiagnostics-coloralways编译输出使用彩色高亮方便区分错误和警告-g生成调试信息GDB 调试必需-Wall开启所有常见警告-Wextra开启额外警告帮助发现潜在问题-o ${fileDirname}/${fileBasenameNoExtension}.exe输出文件与源文件同目录、同名扩展名为.exeVS Code 内置变量说明变量含义${workspaceFolder}工作区根目录的完整路径${file}当前活动文件的完整路径${fileDirname}当前文件所在的目录路径${fileBasenameNoExtension}当前文件名不含扩展名如main第六步配置调试环境创建launch.json文件配置 GDB 调试器。文件路径.vscode/launch.json{version:0.2.0,configurations:[{name:C/C: gcc.exe 生成和调试活动文件,type:cppdbg,request:launch,program:${fileDirname}/${fileBasenameNoExtension}.exe,args:[],stopAtEntry:false,cwd:${fileDirname},environment:[],externalConsole:false,MIMode:gdb,miDebuggerPath:C:/mingw64/bin/gdb.exe,setupCommands:[{description:Enable pretty-printing for gdb,text:-enable-pretty-printing,ignoreFailures:true},{description:Set Disassembly Flavor to Intel,text:-gdb-set disassembly-flavor intel,ignoreFailures:true}],preLaunchTask:C/C: gcc.exe 生成活动文件}]}需要修改的地方将miDebuggerPath改为你本机gdb.exe的实际路径。配置项说明字段说明type调试器类型使用cppdbgMicrosoft C/C 扩展的调试适配器requestlaunch启动程序attach附加到已运行的进程program要调试的可执行文件路径args传递给程序的命令行参数stopAtEntrytrue则在main函数入口处自动暂停externalConsoletrue弹出独立控制台窗口false使用 VS Code 内置终端MIMode调试器类型MinGW-w64 使用gdbmiDebuggerPathGDB 可执行文件的绝对路径preLaunchTask启动调试前自动执行的编译任务对应tasks.json中的label第七步使用方式编译在 VS Code 中打开一个.c或.cpp文件按Ctrl Shift B执行默认编译任务gcc 编译当前文件编译成功后.exe文件生成在源文件同目录下若需切换到 g 编译 C 文件按Ctrl Shift P→ 输入Tasks: Run Task→ 选择C/C: g.exe 生成活动文件调试在代码行号左侧点击设置断点红色圆点按F5启动调试使用调试工具栏快捷键功能F5继续运行到下一个断点F10单步跳过不进入函数F11单步跳入进入函数内部Shift F11单步跳出跳出当前函数Ctrl Shift F5重启调试Shift F5停止调试在终端中手动编译# 编译 C 文件gcc-g-Wall-Wextra-ooutput.exe source.c# 编译 C 文件g-g-Wall-Wextra-ooutput.exe source.cpp# 运行./output.exe常见问题Q: VS Code 报错 “找不到 C/C 扩展”A: 按CtrlShiftX搜索ms-vscode.cpptools并安装。安装后重启 VS Code。Q: 编译报错 “gcc: command not found”A: 检查tasks.json中的command路径是否正确指向你本机的gcc.exe。在终端中手动测试C:\mingw64\bin\gcc.exe--versionQ: IntelliSense 报错但编译正常A: 检查c_cpp_properties.json中的compilerPath是否正确。IntelliSense 依赖该路径查找系统头文件路径错误会导致头文件找不到的误报。Q: 调试时断点不生效 / 显示为空心圆A: 确保编译时包含-g参数本配置已默认添加。如果没有-g编译产物中不包含调试信息GDB 无法设置断点。Q: 调试时报错 “Unable to start debugging”A: 检查launch.json中的miDebuggerPath是否正确指向gdb.exe。同时确保preLaunchTask的值与tasks.json中的label完全一致。Q: 中文输出乱码A: Windows 终端默认使用 GBK 编码而源文件通常是 UTF-8。解决方案方法一在源文件中设置 locale#includelocale.hintmain(){setlocale(LC_ALL,);printf(你好世界\n);return0;}方法二在编译参数中指定执行字符集添加到tasks.json的args中-fexec-charsetGBK方法三在 VS Code 终端中切换编码chcp65001Q: 32 位系统如何配置A: 下载i686-*版本的 MinGW-w64并将c_cpp_properties.json中的intelliSenseMode改为windows-gcc-x86。完整文件结构配置完成后项目目录结构如下你的项目/ ├── .vscode/ │ ├── c_cpp_properties.json ← IntelliSense 配置 │ ├── tasks.json ← 编译任务配置 │ └── launch.json ← 调试配置 ├── hello.c ← 你的源代码 └── ....vscode文件夹可以复制到任何 C/C 项目中使用只需修改其中的 MinGW-w64 路径即可。