跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
C++

VS Code 配置 C/C++ 编程运行环境

VS Code 配置 C/C++ 开发环境涉及安装编辑器与编译器工具链。步骤包括下载并安装 Visual Studio Code 及 MinGW-W64,配置系统环境变量以识别 gcc/g++ 和 gdb。随后在 VS Code 中安装 C/C++ 扩展插件,创建项目文件夹并编写测试代码验证编译运行。支持单文件及多文件项目的调试配置,通过修改 tasks.json 和 launch.json 实现自定义构建与断点调试功能。

灭霸发布于 2026/3/26更新于 2026/5/88 浏览
VS Code 配置 C/C++ 编程运行环境
软件下载
1. 下载 VS Code 安装工具

官方下载链接:Visual Studio Code

安装界面

直接点击'Download for Windows'即可下载。

2. 下载 MinGW-W64

MinGW-W64 可从官网或 GitHub 下载。GitHub 链接如下:

MinGW-W64 下载链接: Releases · msys2/msys2-installer (github.com)

进入链接后查看历史版本,截至本教程编写日期,最新版本为 2024-01-13。单击日期跳转至下载窗口。

版本选择

如下图所示,选择 msys2-x86_64-20240113.exe(前缀是 msys2-x86_64),点击下载标志。

下载文件

安装 VS Code

双击运行 VSCodeUserSetup-x64-1.87.2.exe。

运行安装程序

如果出现弹窗,单击'运行'即可。

安全提示

选择'我同意此协议'并单击'下一步'。

许可协议

这里提示 VS Code 的安装位置,默认路径即可,也可根据硬盘分区情况选择其他路径,点击'下一步'。

安装路径

这一步是创建快捷方式的名字,下面的选项如果不勾选,就会把快捷方式添加到开始菜单中。选择默认,直接点'下一步'。

快捷方式

默认只有最后两项被选中,建议全部选上,单击'下一步'。

附加选项

最后确认一下信息,确认之后直接安装即可。

确认安装

大概一分钟左右就可以安装完成。

安装进度

安装完成后,先暂时不运行 VS Code,去掉勾选,点击'完成'。

完成安装

安装 MinGW-W64 及配置环境变量

双击 msys2-x86_64-20240113.exe 运行安装程序。

MSYS2 安装

注意:MSYS2 需要 64 位 Windows 8.1 及以上版本。

此界面直接点击'下一步'。

MSYS2 欢迎

选择安装的路径,可以根据实际情况修改路径,之后点击'下一步'。

MSYS2 路径

开始菜单中的名字,可以直接默认,点击'下一步'。

MSYS2 菜单名

开始安装。

MSYS2 安装中

待进度条走完,直接点击'下一步'。

MSYS2 完成

默认勾选'立即运行 MSYS2',单击'完成'。

MSYS2 启动

当按下'完成'之后,会弹出打开一个 MSYS2 终端窗口。

MSYS2 终端

在此终端中,通过输入以下命令并按回车键,安装 MinGW-w64 工具链:

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

出现这个界面,直接按回车键,默认接受所有的安装包。

接受包

当系统提示是否继续安装时,请输入 y 并回车。

确认安装

之后就进入安装过程,稍等片刻。

安装过程

当所有的包都安装好后,直接关闭终端。

关闭终端

打开安装 MSYS2 的目录,先找到 ucrt64 文件夹并进入,再找到 bin 文件夹并进入,然后在地址栏中,复制路径。

如果一开始用默认路径,那路径就是 C:\msys64\ucrt64\bin。

复制路径

然后在搜索框中输入 编辑系统环境变量,并打开编辑系统环境变量的设置界面。

环境变量入口

在系统属性的弹窗中,点击'环境变量'。

系统属性

在弹出的环境变量弹窗中,找到用户变量的 Path,并双击打开。

Path 变量

此时会弹出编辑环境变量的窗口,先点击'新建'按钮,然后会在空白行中出现一个输入框和一个闪烁的光标,在这里粘贴上刚才复制的路径,最后点击'确定'按钮回到上层弹窗。

添加 Path

最后逐层弹窗点击'确定'按钮退出即可。

完成设置

最后做一下测试,按组合键 Win + r 之后,输入 cmd 回车。

CMD 打开

回车之后,就可以调出 CMD 的终端窗口了,然后分别输入下面的命令,每输入一次命令后回车一次。

gcc --version g++ --version gdb --version 

出现如下图一样的信息,就说明 C/C++ 的编译环境已经安装好。

版本验证

配置 VS Code 的 C/C++ 编程运行环境
1. 汉化 VS Code(选做)

这个配置环节并不属于 C/C++ 编程运行环境的配置必要环节,想适应英文开发环境的同学可以跳过。

考虑到很多同学的英文水平可能不是很好,对于全英文的开发环境会犯难,这里可以使用 VS Code 自带的汉化插件来解决这个问题。

首先启动 VS Code 软件,按下组合键 Ctrl + Shift + x,或者直接点击左边的第五个小图标,进入 Extensions。

扩展中心

在上方输入框中键入 Chinese,扩展插件的列表会刷新出汉化插件,点击对应的 Install 按钮进行安装。

安装汉化

安装好后,软件界面的右下角会弹出通知,并附带 Change Language and Restart 的按钮,点击这个按钮,即可重启软件。

重启提示

软件重启后,就是中文的界面了。

中文界面

2. 安装 C/C++ 扩展包

在 Extensions 中搜索'C++',列表第一个扩展包就是我们要的,点击'安装'即可。

C++ 扩展

提示:上图中的 C/C++ Extension Pack 是 C/C++ 的扩展功能包,里面包含了一些项目管理和代码构建的工具,不是必要的扩展包,可以选择性安装。

测试 VS Code 的 C/C++ 编程环境
1. 创建代码文件夹

VS Code 是一款基于文件夹进行代码编辑和管理的编辑器,通常我们会把新建一个文件夹来管理同一个项目的代码,并在 VS Code 中打开。

我新建了一个名为 Code 的文件夹,并在里面新建了一个用于专门放 C 语言代码的文件夹。

文件夹结构

注意:需要注意的是,这个路径最好不要存在中文,否则会出现编译失败等问题。

打开 VS Code,点击'打开文件夹'的按钮。

打开文件夹

在弹窗中找到刚刚新建的 C 文件夹,选中文件夹,再点'选择文件夹'。

选择文件夹

选中文件夹后,在新弹出的窗口中,勾选上'信任父文件夹"Documents"中所有文件的作者',再点'是,我信任此作者'。

信任作者

文件添加好后,在左边的资源管理器中会出现 CODE 文件夹以及子文件夹 C,把鼠标放在文件夹上面,会出现四个小图标。四个小图标从左往右的作用分别是新建文件、新建文件夹、刷新资源管理器以及在资源管理器中折叠文件夹。

资源管理器

好了,做到这一步,接下来就可以进行代码的运行和调试了。

2. 单个 .c 文件的运行和调试

为了方便管理代码,我们先选中 C 文件夹,再点击'新建文件夹'按钮。

新建文件夹

此时会在 C 文件夹的下级出现一个输入框,我们新建一个名为 test 的文件夹。

test 文件夹

鼠标右键 test 文件夹,在弹出的菜单中选择'新建文件'。

新建文件

在输入框中输入我们接下来要进行调试代码文件名,命名为 test.c,注意,一定要是 .c 结尾。

test.c

接下来就可以输入一个调试程序了,代码如下:

#include<stdio.h>
int main(){
    for(int i = 0; i < 5; i++)
        printf("Hello Grayson~%d\n", i);
    return 0;
}

写好测试代码后,点击右上角的调试按钮,这时会弹出调试程序的选项,选择第一个,也是本教程前面安装的 gcc 编译工具。

调试选项

这时文件就被编译并执行,如果在右下角弹出如下窗口,点击'是'即可。

弹窗提示

运行结果如图所示。

运行结果

如果要进行简单的断点调试,可以在行号前加一个断点,操作也很简单,只需用鼠标左键点一下行号左边的空白处即可。如下图所示,是在第六行处加了一个断点。

断点设置

这时再去运行程序,搜索框下面就会出现调试的面板,面板上有六个按钮,分别是继续、逐过程、单步调试、单步跳出、重启和停止。

调试面板

说明:以下是 VS Code 中的 C 语言代码调试面板功能的解释:继续(Continue):继续执行程序,直到遇到下一个断点或程序结束。逐过程(Step Over):逐行执行当前行,如果当前行是函数调用,则进入该函数并执行完毕。单步调试(Step Into):逐行执行当前行,如果当前行是函数调用,则进入该函数并停在函数内的第一行。单步跳出(Step Out):执行完当前函数的剩余部分,并停在当前函数被调用的下一行。重启(Restart):重新启动程序的调试会话,即从程序的起点开始执行。停止(Stop):停止程序的调试会话,结束调试过程并关闭程序执行。

目前这个程序还不能很好说明以上的调试功能(至少逐过程、单步调试和单步跳出这三个并不明显),所以在后面的内容将以另一个代码进行演示。

3. 多个 .c 文件的运行与调试

如果想要进行多个 .c 文件编译后的调试,就需要进行一些配置修改。如果进行过一次编译运行,我们会发现在资源管理器的 C 文件夹下,多出一个 .vscode 的文件夹,这个文件夹里面有个 tasks.json 的文件。

vscode 文件夹

这个文件是用于定义任务配置,这些任务可以在 VS Code 中运行,例如编译代码、运行测试、启动调试器等。tasks.json 文件是一个 JSON 格式的文件,其中包含了任务的配置信息,包括任务名称、命令、参数等。通过编辑 tasks.json 文件,我们可以自定义项目中的各种任务,并在 VS Code 中方便地执行这些任务。

当前的 VS Code 的运行效果还不是很理想,双击打开 tasks.json 文件修改一下编译运行功能。下图是对该 JSON 文件做了部分解释。

tasks.json 解释

具体修改如下图所示,我注释掉了原来的 ${file},并新增一行 *.c,表示并非指定某一个 .c 文件,而是当前文件夹下所有的 .c 文件。同时也把 ${fileDirname}\${fileBasenameNoExtension}.exe 注释掉,改成 ${fileDirname}\program.exe,那么多个 .c 文件编译之后的可执行文件就是 program.exe。

tasks.json 修改

修改好后,按组合键 Ctrl + s 保存即可。

然后点击左侧的'运行与调试',再点击'创建 launch.json 文件'。

launch.json

搜索框会弹出选项,选择 C++(GDB/LLDB)。

选择调试器

然后 VS Code 会新建一个 JSON 文件,点击右下角的'添加配置',在弹出的下拉菜单中选择 C/C++:(gdb)启动。

添加配置

此时,JSON 文件会多出一些配置信息,需要我们修改的内容如下图所示的红框标志内容。

launch.json 配置

修改为下图红框所示内容,'program' 后的内容就是前面提到的 tasks.json 文件中的编译后产生的可执行文件。"miDebuggerPath" 后面的则是前面安装的 MinGW-W64 的 gdb 工具的路径。修改后保持关闭。

gdb 路径

注意:在复制粘贴 gdb 的路径时,不少小伙伴会忽略掉下图所示的问题。反斜杠是转义字符的作用,应该像上图一样多加一个一个反斜杠才表示路径。

之后,我们进行多文件的编译调试,先在 C 文件夹下新建一个新的文件夹,我这里命名为 test2,并在这个文件夹里面新建三个文件,分别是 test.c、max.h 和 max.c。

多文件

代码如下:

max.h

#ifndef __MAX_H__
#define __MAX_H__
#include<stdio.h>
int findMaxNum(int num1, int num2);
#endif // __MAX_H__

max.c

#include "max.h"
int findMaxNum(int num1, int num2){
    return num1 > num2 ? num1 : num2;
}

test2.c

#include<stdio.h>
#include"max.h"
int main(){
    int a = 10;
    int b = 20;
    int c = findMaxNum(a, b);
    printf("%d\n", c);
    return 0;
}

代码写好后,给 test2.c 的第 8 行代码打一个断点,再点调试按钮旁边的小三角形,在下拉菜单中选择'调试 C/C++ 文件'。

调试多文件

调试面板依旧是之前的那个。如果点击'继续',调试过程会跳到下一个断点,不过我们这个程序只打了一个断点,所以会直接运行到程序结束并退出调试。

继续调试

如果点击'逐过程',则在不进入函数内部,而是直接输出函数的运行结果,然后跳到下一行。

逐过程

如果点击'单步调试',则会进入被调用函数的内部,继续点击'单步调试'会一步一步执行并返回。如果进入函数后,点击'单步跳出'则直接带着函数的执行结果返回被调用处。

单步调试


参考资料

《Running Visual Studio Code on Windows》

《C++ programming with Visual Studio Code》

《Get Started with C++ and MinGW-w64 in Visual Studio Code》

目录

  1. 软件下载
  2. 1. 下载 VS Code 安装工具
  3. 2. 下载 MinGW-W64
  4. 安装 VS Code
  5. 安装 MinGW-W64 及配置环境变量
  6. 配置 VS Code 的 C/C++ 编程运行环境
  7. 1. 汉化 VS Code(选做)
  8. 2. 安装 C/C++ 扩展包
  9. 测试 VS Code 的 C/C++ 编程环境
  10. 1. 创建代码文件夹
  11. 2. 单个 .c 文件的运行和调试
  12. 3. 多个 .c 文件的运行与调试
  13. 参考资料
  • 💰 8折买阿里云服务器限时8折了解详情
  • GPT-5.5 超高智商模型1元抵1刀ChatGPT中转购买
  • 代充Chatgpt Plus/pro 帐号了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 前端缓存策略:让你的网站飞起来
  • Redis Hash 详解:C++ 实战与高性能对象存储策略
  • Ubuntu 24.04 系统下 VNC Server 安装与配置指南
  • C++ 模板进阶:非类型参数、特化与分离编译
  • 大模型分布式训练与高效调参技术实战
  • 2023 年网络安全十大发展趋势深度解析
  • 自然语言处理在客户服务领域的应用与实战
  • iOS 网络安全实战:HTTPS 通信与证书锁定防抓包
  • GitHub Trending AI Top3 项目解析与上手指南
  • 赛博塔罗 Java 与前端实现方案
  • GitNexus 核心引擎:索引、社区检测与混合搜索
  • 预训练语言模型与 BERT 实战应用
  • 基于 Spring Boot 与 Leaflet 的省级旅游口号 WebGIS 可视化实现
  • 时序数据库选型指南:Apache IoTDB 核心优势分析
  • Microsoft Edge WebView2 Runtime 运行库快速部署与调试指南
  • 华为昇腾 910B 使用 LLaMA-Factory 微调 Qwen3.5-32B 模型
  • Xilinx FPGA LVDS 电源与电平配置关键指南
  • Docker Compose 多实例 Tomcat 部署示例
  • OpenClaw 多端交互实战指南:Web/TUI/钉钉集成详解
  • AI 产品架构设计:从 0 到 1 搭建信息架构与核心流程

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online