2026年如果你准备学习 C/C或者因为考研复试、算法竞赛、课程设计需要在 Windows 本机上配一套 C/C 开发环境那么 Visual Studio CodeVSCode几乎是绕不开的选择。相比 Visual StudioVSCode 轻量、免费、跨平台配合 MinGW-w64 和 GDB 调试器完全可以完成从编写、编译到调试的全流程开发。不过很多初学者在“装 VSCode”这一步很容易卡住编译器装完了还是提示g 不是内部或外部命令好不容易写好代码又不知道如何配置调试断点打上了却一直不生效。这篇文章会从零开始完整演示 Windows 环境下 VSCode 安装、MinGW-w64 安装与环境变量配置、C/C 插件安装、任务配置、调试配置以及高频报错的排查思路。读者只要能按照步骤操作最终都能在自己的电脑上跑通 C 和 C 程序并且能够使用断点调试功能。1. VSCode 与 C/C 开发环境概述1.1 为什么选择 VSCode 开发 C/C在 Windows 上开发 C/C常见选择有三种Visual Studio功能全面MSVC 编译器、调试器、项目模板都集成好了适合大型 Windows 桌面项目。CLionJetBrains 出品对 CMake 支持极好但需要付费且占用内存较高。VSCode免费开源插件生态丰富启动快适合学习、算法刷题、轻量级项目开发。对于大多数学生、考研党、算法竞赛选手以及刚接触 C/C 的开发者来说VSCode 的性价比最高。你不需要打开一个几 GB 的 IDE只需要会管理文件夹就能用 VSCode 完成日常开发和调试。1.2 核心工具链的职责划分很多教程会把“装 VSCode”和“配 C/C 环境”混在一起但实际上它们是完全不同的两件事VSCode 是一个编辑器负责代码高亮、补全、格式化、断点管理。编译器GCC/G负责把.c/.cpp源码编译成可执行的.exe文件。调试器GDB负责在程序运行时暂停、单步执行、查看变量和内存。简单来说VSCode 只是“门面”真正干活的是 G 编译器和 GDB 调试器。所以安装 MinGW-w64 和配置环境变量是整个过程的核心也是初学者最容易出错的环节。1.3 本文适合哪些读者本文适合以下读者Windows 下从零配置 C/C 开发环境的新手。使用 Code::Blocks 或 Dev-C 时间较长想换 VSCode 的同学。算法刷题需要快速编译、调试单文件程序的选手。需要掌握 GDB 断点调试的 C/C 学习者。如果你已经熟悉 VSCode 的基本操作可以直接跳到第 4 节看编译器配置或者跳到第 7 节看调试配置。2. 环境准备与版本说明2.1 操作系统要求本教程以 Windows 10/11 64 位系统为例。Windows 7 及更老的系统不推荐继续使用因为新版 VSCode 和 MinGW-w64 对老系统支持有限。如果你的电脑是 macOS 或 Linux思路是一样的只是编译器安装方式不同本文不展开。2.2 软件清单软件作用是否必须Visual Studio Code代码编辑器必须MinGW-w64含 G/GCC/GDB编译器和调试器必须C/C 插件Microsoft语法高亮、智能提示、调试支持必须Code Runner 插件快速运行单个文件推荐这里需要特别说明VSCode 本身只是一个编辑器它不自带编译器。不要只安装 VSCode 就以为环境配置完成必须额外安装 MinGW-w64。2.3 版本选择建议截止到本文整理时VSCode 官方稳定版迭代较快直接到官网下载最新稳定版即可。编译器方面老版本的 MinGW-w64 已经有很长时间没有更新建议选择以下方式获取较新版本的 GCCMSYS2 环境中的 mingw-w64 工具链。w64devkit 便携版工具包。WinLibs 提供的 MinGW-w64 构建版本。这些工具链都包含gcc.exe、g.exe、gdb.exe能够支持 C17/C20 特性。具体版本号以后续下载页面为准不需要过度纠结能够正常编译和调试即可。3. VSCode 安装与基础设置3.1 下载与安装打开 VSCode 官网选择 Windows 版本下载安装包。这里建议选择“User Installer”或者“System Installer”两者区别在于安装权限范围普通开发者选择 User Installer 更省心。下载完成后双击安装包按以下步骤操作勾选“我同意此协议”点击下一步。选择安装目录默认安装在C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code。在选择附加任务时建议勾选“添加到 PATH”、“将‘通过 Code 打开’操作添加到文件和目录上下文菜单”、“将‘在 Code 中打开’操作添加到目录上下文菜单”。点击安装等待完成。安装完成后打开 VSCode界面默认是英文。如果希望使用中文界面可以按CtrlShiftX打开扩展面板搜索Chinese Language Pack安装后重启 VSCode 即可。3.2 VSCode 基础设置界面切换到中文后可以按Ctrl,打开设置建议先做几项基础调整搜索font size将字体大小调整为适合当前屏幕的数值一般在 14-16 之间。搜索auto save设置为afterDelay这样代码会自动保存避免忘记保存导致编译的还是旧版本。搜索word wrap设置为on避免代码过长时需要左右拖动。搜索format on save勾选此选项可以在保存时自动格式化代码。这些设置都可以在设置页面的搜索框直接输入关键词然后点击对应选项修改不需要手动编辑 settings.json。如果你习惯用配置文件可以按CtrlShiftP输入Open User Settings (JSON)打开 JSON 文件手动添加配置。3.3 常用快捷键速查VSCode 的快捷键非常多但刚起步只需要掌握几个高频操作快捷键作用CtrlShiftX打开扩展面板CtrlShiftP打开命令面板Ctrl\\拆分编辑器Ctrl,打开设置F5启动调试CtrlF5运行但不调试ShiftCtrlB执行编译任务这几个快捷键在后续操作中会反复用到。4. MinGW-w64 与 G 编译器的安装配置4.1 什么是 MinGW-w64MinGW-w64 是 Windows 平台下的一套开源编译工具链提供了 GCC、G、GDB、Windows API 导入库等工具。简单说它就是在 Windows 上运行的 Linux GCC 工具链能够把 C/C 源码编译成 Windows 可执行的.exe文件。注意区分两个名字MinGW 是早期的 32 位版本维护已经不太活跃MinGW-w64 是它的后继版本支持 64 位编译目标也是当前更推荐的选择。4.2 安装方式一MSYS2推荐MSYS2 是一个提供 Linux 风格软件包管理工具的软件发行版通过它可以方便地安装、更新 MinGW-w64 工具链。进入 MSYS2 官网下载最新安装包。安装完成后打开MSYS2 MSYS终端。输入以下命令更新软件包数据库pacman -Syu如果更新过程中要求关闭终端请按照提示关闭后重新打开 MSYS2再次执行一次更新命令。安装 MinGW-w64 工具链pacman -S --needed base-devel mingw-w64-x86_64-toolchain这个命令会把gcc、g、gdb、make等工具一起安装。安装完成后默认目录位于C:\msys64\mingw64\bin。4.3 安装方式二w64devkit如果你不想安装 MSYS2也可以使用 w64devkit 便携版。它是一个压缩包解压后就能使用无需安装。搜索 w64devkit 并下载最新 release 压缩包。解压到某个固定目录例如D:\w64devkit。解压后的bin目录就是需要配置到环境变量的路径。这种方式更加轻量适合只用来做 C/C 开发和算法练习的场景。4.4 配置环境变量无论使用哪种方式安装都需要将编译器所在的bin目录添加到 Windows 环境变量 Path 中否则终端和 VSCode 无法找到g命令。以 MSYS2 为例bin目录是C:\msys64\mingw64\bin。以 w64devkit 为例可能是D:\w64devkit\bin。请根据自己的实际安装路径来替换。配置步骤如下按Win S搜索环境变量打开“编辑系统环境变量”。点击右下角的“环境变量”。在“系统变量”中找到Path选择后点击“编辑”。点击“新建”粘贴你的 MinGW-w64 bin 目录路径。点击“确定”保存所有窗口。步骤示意如下Windows 设置搜索“环境变量” - 系统属性 - 环境变量 - 系统变量 - Path - 编辑 - 新建 - 填入 C:\msys64\mingw64\bin4.5 验证安装配置完环境变量后需要重新打开一个终端让新的环境变量生效。可以按Win R输入cmd打开命令行窗口然后执行gcc --version g --version gdb --version如果能正确输出版本信息就说明编译器和调试器已经安装成功。例如 g 的输出会显示类似g (MinGW-W64 x86_64-ucrt-posix-seh, built by Brecht Sanders) 13.2.0如果提示“g 不是内部或外部命令”说明环境变量没有配置正确请重新检查 bin 目录路径或者重启电脑后再试。5. 安装 VSCode 必备插件5.1 插件市场入口VSCode 的扩展能力是它的核心优势。按CtrlShiftX可以打开扩展面板在搜索框输入插件名后点击“安装”即可。插件安装后不需要重启但个别插件会要求重载窗口。5.2 核心插件列表以下是 C/C 开发必备及推荐插件插件名作用必须程度C/C官方 C/C 语言支持提供语法高亮、IntelliSense、调试功能必须C/C Extension PackC/C 扩展全家桶推荐Code Runner一键运行当前文件适合算法刷题和验证代码非常推荐Chinese Language PackVSCode 中文界面可选Better C Syntax增强 C 语法高亮可选CMake ToolsCMake 项目管理工具进阶需要Markdown All in OneMarkdown 文档编辑增强写笔记时用5.3 安装 C/C 扩展在扩展面板搜索C/C选择微软官方发布的C/C插件作者为 Microsoft安装量一般都在数千万级别。安装后建议重启 VSCode让插件完全加载。如果插件市场因为网络原因无法访问可以尝试以下办法检查电脑网络连接是否正常关闭代理或切换网络环境后重试。在扩展面板搜索确认是否因为网络不稳定导致搜索结果加载失败稍后重试。请网络正常的同学帮忙下载对应的.vsix文件然后在 VSCode 中按CtrlShiftP输入Install from VSIX选择下载好的文件进行安装。5.4 设置文件编码C/C 插件安装后建议在设置中确认文件编码。在 VSCode 右下角可以看到当前文件编码默认是 UTF-8。如果你打算在源码中写中文字符串且运行环境是 Windows 命令行中文乱码是常见问题。这一步先保留默认编码后续在第 8 节会专门讲如何解决乱码。6. 编写第一个 C/C 程序6.1 创建工作目录建议为每个 C/C 项目单独建一个文件夹不要在桌面散着放代码。例如在D:盘下新建CppProjects再在里面新建lesson01。打开 VSCode点击菜单栏“文件”-“打开文件夹”。选择D:\CppProjects\lesson01文件夹。点击“选择文件夹”此时 VSCode 左侧资源管理器会显示空目录。6.2 编写 hello.c在资源管理器区域点击新建文件按钮输入文件名hello.c然后复制以下代码#include stdio.h int main() { printf(Hello, CSDN!\n); return 0; }这是一个最基础的 C 程序。#include stdio.h引入标准输入输出头文件printf用于输出内容main是程序入口函数。6.3 使用 G 手工编译运行在 VSCode 中按Ctrl\\ 打开终端确保终端当前路径在lesson01 文件夹下然后执行gcc hello.c -o hello.exe-o参数表示指定输出文件名hello.exe就是编译生成的可执行文件。继续执行./hello.exe可以看到输出Hello, CSDN!这一步说明编译器工作正常环境变量配置正确。如果你在终端里执行gcc仍然提示找不到命令需要回到第 4.5 节重新检查环境变量。6.4 编写 hello.cpp接下来测试 C 程序。新建文件hello.cpp内容如下#include iostream int main() { std::cout Hello, C! std::endl; return 0; }使用 g 编译g hello.cpp -o hello_cpp.exe运行./hello_cpp.exe输出为Hello, C!到这里你已经完成了 C 和 C 两个程序的手工编译运行整个工具链已经打通。6.5 使用 Code Runner 快速运行如果每次都要在终端敲gcc和./hello.exe效率实在太低。安装 Code Runner 插件后点击编辑器右上角的三角形按钮或者按快捷键CtrlAltN插件会自动调用编译器编译并运行当前文件。Code Runner 默认会使用系统找到的编译器。如果你想指定 gcc 或 g可以在设置中搜索code-runner.executorMap手动调整。例如code-runner.executorMap: { c: cd $dir gcc $fileName -o $fileNameWithoutExt ./$fileNameWithoutExt, cpp: cd $dir g $fileName -o $fileNameWithoutExt ./$fileNameWithoutExt }注意$dir表示当前文件所在目录$fileName是当前文件名$fileNameWithoutExt是没有扩展名的文件名。这套模板非常常用。7. VSCode 配置任务与调试Code Runner 可以快速运行代码但无法进行断点调试、单步执行、查看变量。真正需要调试时必须配置tasks.json和launch.json。7.1 配置编译任务 tasks.json调试前我们需要先让 VSCode 知道“用什么命令把源码编译成 exe”。按CtrlShiftP输入Tasks: Configure Default Build Task选择C/C: g.exe 生成活动文件。如果你的 VSCode 没有自动生成也可以手动在项目目录下创建.vscode文件夹新建tasks.json内容如下{ version: 2.0.0, tasks: [ { label: C/C: g.exe 生成活动文件, type: cppbuild, command: C:/msys64/mingw64/bin/g.exe, args: [ -fdiagnostics-coloralways, -g, -stdc17, ${file}, -o, ${fileDirname}\\${fileBasenameNoExtension}.exe ], options: { cwd: ${fileDirname} }, problemMatcher: [ $gcc ], group: { kind: build, isDefault: true }, detail: 调试器生成的任务。 } ] }需要重点解释几个参数command编译器路径。如果你的 g.exe 不在C:/msys64/mingw64/bin/要改成你自己的实际路径。-g生成调试信息这是调试能命中断点的前提。没有-g断点调试基本无法生效。-stdc17指定 C 标准版本可以根据需要改成c11、c14、c20。${file}当前打开的文件。${fileDirname}当前文件所在目录。${fileBasenameNoExtension}当前文件名去掉扩展名。保存 tasks.json 后按CtrlShiftBVSCode 就会编译当前打开的 C 文件。如果编译成功会在终端不显示错误如果语法有错会在“问题”面板显示错误详情。7.2 配置调试文件 launch.json编译任务就绪后还需要告诉调试器“调试哪个 exe 文件、使用哪个调试器”。按CtrlShiftP输入Debug: Open launch.json选择C (GDB/LLDB)然后选择g.exe 生成和调试活动文件。也可以手动在.vscode文件夹新建launch.json{ version: 0.2.0, configurations: [ { name: C/C: g.exe 生成和调试活动文件, type: cppdbg, request: launch, program: ${fileDirname}\\${fileBasenameNoExtension}.exe, args: [], stopAtEntry: false, cwd: ${fileDirname}, environment: [], externalConsole: true, MIMode: gdb, miDebuggerPath: C:/msys64/mingw64/bin/gdb.exe, setupCommands: [ { description: 为 gdb 启用整齐打印, text: -enable-pretty-printing, ignoreFailures: true } ], preLaunchTask: C/C: g.exe 生成活动文件 } ] }几个关键配置项program要调试的可执行文件路径默认和编译输出保持一致。externalConsole设为true时程序运行在独立的外部终端能正常读取输入设为false时使用 VSCode 内置终端但某些输入场景可能有问题。miDebuggerPathgdb.exe 的绝对路径需要改成你的实际路径。preLaunchTask启动调试前先执行的任务值必须和 tasks.json 里的label完全一致。这里特别提醒launch.json中的文件路径如果出现反斜杠JSON 中需要写双反斜杠\\\\或者统一使用正斜杠/。7.3 打断点与启动调试配置完成后打开你写的hello.cpp在代码左侧灰色区域点击会出现红色圆点这就是断点。断点设置在第 5 行std::cout这一行比较合适。然后按F5VSCode 会先执行编译任务然后启动 gdb 调试。程序运行到断点处会暂停此时左侧“运行和调试”面板会显示局部变量。顶部出现调试工具栏包含继续、单步跳过、单步进入、单步退出、重启、停止等按钮。如果一切正常你会看到调试工具栏代码行高亮停在断点处。7.4 调试面板使用说明调试工具栏的每个按钮含义如下按钮作用快捷键继续继续运行到下一个断点F5单步跳过执行当前行不进入函数内部F10单步进入进入当前行调用的函数内部F11单步退出跳出当前函数ShiftF11重启重新启动调试CtrlShiftF5停止结束调试ShiftF5左侧面板还可以手动添加监视表达式。例如在“监视”区域点击加号输入i就能实时查看变量i的变化。这个功能在排查循环和递归时非常高效。7.5 多文件项目的调试思路上面的配置只对单文件程序有效。如果项目有多个.cpp文件再用${file}编译就不合适了。此时有两个方向在 tasks.json 中把${file}改成多个源文件例如src/main.cpp, src/utils.cpp。使用 CMake 管理项目再配合 CMake Tools 插件完成配置、编译、调试。对于初学者建议先用单文件配置把调试流程跑通再逐步学习 CMake。8. 常见问题与排查思路环境配置类问题千奇百怪但很多新手踩的坑高度相似。下面按“优先检查顺序”整理排查清单。8.1 g 不是内部或外部命令原因没有安装 MinGW-w64或者安装后没有把bin目录加入系统环境变量 Path。解决方法确认C:\\msys64\\mingw64\\bin或你的实际安装路径中存在g.exe。重新配置环境变量配置后重启终端。在终端用where g验证。8.2 编译器路径总是报错原因tasks.json 或 launch.json 中的路径与实际安装路径不一致。很多复制教程配置的人会忘记修改command和miDebuggerPath。解决方法打开终端执行where g得到 g.exe 的实际路径再把这个路径完整替换到 tasks.json 和 launch.json 中。8.3 中文乱码问题原因源码文件是 UTF-8 编码而 Windows 命令行默认使用 GBK 编码两者不一致就会显示乱码。解决方法方法一在代码开头切换命令行代码页#include stdio.h #include stdlib.h int main() { system(chcp 65001); printf(你好CSDN\n); return 0; }chcp 65001将命令行编码切换到 UTF-8。方法二在 tasks.json 的编译参数中加入编码转换-fexec-charsetGBK这条参数让编译器把字符串常量按照 GBK 编码写入 exe 文件和 Windows 默认命令行一致。8.4 程序一闪而过原因在 VSCode 内置终端运行时程序执行完毕终端会立即关闭看不到输出结果。常见于直接双击 exe 或使用某些运行插件时。解决方法在 launch.json 中设置externalConsole: true让程序运行在独立终端屏幕会停留。或者在代码末尾临时添加system(pause);但正式学习时不建议依赖这种写法。也可以直接使用调试模式按F5程序暂停在断点时不会退出。8.5 调试时无法命中断点原因最常见的有三种编译时没有加-g参数调试的 exe 和当前源码不对应编译器优化导致源码行号和实际执行语句不一致。解决方法检查 tasks.json 的 args 中是否包含-g。清理旧 exe重新按CtrlShiftB编译。检查 launch.json 的program路径是否与编译输出路径一致。删除 tasks.json 中-O2等优化参数调试阶段尽量不要开优化。8.6 插件市场打不开或搜索失败原因网络访问不稳定或者公司/校园网代理配置问题。解决方法检查系统代理和网络连接。尝试点击 VSCode 左下角设置齿轮选择“命令面板”输入Developer: Reload Window重新加载。等待一段时间后重试或者使用离线安装.vsix文件的方式。8.7 常见问题汇总表问题现象常见原因解决思路g不是内部或外部命令MinGW-w64 未安装或 Path 配置失败检查 bin 目录并重新配置环境变量编译成功但调试异常launch.json 路径不对用where g确认路径程序中文输出乱码UTF-8 源码 GBK 命令行使用chcp 65001或-fexec-charsetGBK断点不生效缺少-g或优化开启加上-g去掉优化选项控制台一闪而过程序结束后终端关闭使用外部终端或system(pause)9. 最佳实践与工程建议到这里你已经能够完成“安装 - 编译 - 运行 - 调试”的完整流程。下面补充一些工程实践建议帮助你从“环境能用”走向“环境好用”。9.1 项目目录规范即使只做单文件练习也建议按项目目录管理代码。一个常见的 C 项目结构如下D:\CppProjects\lesson01 ├── .vscode │ ├── tasks.json │ └── launch.json ├── src │ └── main.cpp ├── include │ └── my_header.h ├── build └── CMakeLists.txt对于简单学习项目.vscode目录放 VSCode 专属配置src放源码build放编译产物不要把生成的.exe文件和源码混在一起。9.2 用 CMake 管理多文件项目当代码量增大后直接写 tasks.json 编译命令会变得非常痛苦。CMake 是跨平台 C/C 项目构建工具配合 CMake Tools 插件可以解决绝大多数构建需求。一个最简单的 CMakeLists.txt 如下cmake_minimum_required(VERSION 3.16) project(MyProject) set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) add_executable(main src/main.cpp src/utils.cpp)然后在 VSCode 中安装 CMake Tools 插件按CtrlShiftP输入CMake: Configure选择编译器工具链后即可完成配置之后就可以使用插件自带的“调试”按钮启动调试。CMake 的学习曲线比直接写 tasks.json 稍陡但这是走向真实 C 项目的必经方向建议在完成本文基础调试后尽快接触。9.3 常用插件补充除了 C/C 和 Code Runner以下几款插件可以在后续开发中按需安装vscode-icons给不同类型文件显示不同图标文件树更清晰。Error Lens把编译错误直接显示在代码行行尾肉眼可见。GitLens增强 Git 功能代码提交时能快速看到改动来源。Markdown All in One写笔记、写 README 时非常方便。CMake Tools上面提到的 CMake 管理插件。9.4 代码格式化与规范在 VSCode 中按ShiftAltF可以自动格式化当前文件。对于 C/C 新手我建议从一开始就养成格式化习惯编写代码时注意函数名、变量名使用有意义的英文单词。函数内缩进保持统一不要混用空格和 Tab。大括号换行风格保持统一例如 KR 风格或 Allman 风格都可以但一整份代码要一致。在 VSCode 设置中搜索C_Cpp: Clang_format_fallback Style可以设置格式化风格例如{ BasedOnStyle: Google, IndentWidth: 4 }表示基于 Google 风格但缩进改成 4 空格。9.5 调试与日志的取舍调试器确实很强大但在复杂项目中并不是所有问题都能通过断点解决。很多时候问题发生在循环第 10000 次迭代或者发生在某个并发回调里这时候断点调试非常痛苦。建议同时掌握带日志的输出调试法在关键位置用std::cerr输出变量状态跑完后再结合日志分析。可以说断点调试负责定位“局部状态”日志负责还原“全局运行轨迹”两者结合才高效。10. 总结与下一步学习方向本文详细讲解了 Windows 下 Visual Studio Code 安装、MinGW-w64 工具链配置、C/C 插件安装、单文件编译运行和 GDB 断点调试的完整流程并整理了g 不是内部或外部命令、中文乱码、断点不生效等高频问题的排查思路。经过本文的操作你应该已经掌握了几个核心能力能独立完成 VSCode 和 MinGW-w64 的安装配置。能用gcc/g手动编译 C 和 C 文件。能配置 tasks.json 和 launch.json实现 F5 一键调试。能使用单步跳过、监视变量等调试技巧。接下来可以把目光放到三个方向第一用 VSCode 刷算法题把 Cod Runner 和调试配合起来使用第二学习 CMake把单文件程序扩展成多文件项目第三选择一个自己感兴趣的小项目比如学生成绩管理系统或通讯录系统把环境真正用起来。配置环境不是终点写出自己的项目才是最有成就感的事。