VScode配置CC++环境详细

admin管理员组

文章数量:1578614

目录

• `阅读本文能学到`
• **前言**
• • **首先理清楚几个问题：**
• **下面进入正题：**
• • **1. VScode**
  • • 1.1 VScode 安装
    • 1.2 安装 C/C++ 插件
  • **2. MSYS2**
  • • 2.1 MSYS2 安装
    • 2.2 下载编译器
    • 2.3 `重点：将编译器所在目录加入环境变量中`
    • 2.4 `验证是否成功将 gcc、g++、gdb 加入环境变量`
  • 3. **VScode 配置 .json**
  • • **1. tasks.json**
    • **2. launch.json**
    • **3. c_cpp_properties.json**
    • **【注】**
  • **写在后面**

阅读本文能学到

• 在一定程度上了解相关配置的目的
• 如何安装 VScode
• 如何下载 C++编译器（以 GCC 为例）
• 如何将编译器路径加入环境变量
• 如何为 VScode 配置 C/C++ 环境

前言

---

对于本文提到的一些名词如果不清楚的请自行百度

对于小白而言，VScode 的 C++ 配置的确容
易劝退，主要原因在于其相关知识的缺乏。拿着手里的文档，只能照着一步一步做，完全不清楚背后的目的，导致出现错误时不知道问题所在，只能干着急，又或者无法找到解决方案，从而放弃。以前的自己也是这么过来的，现在熟悉了此操作，也学了点皮毛，对此有了进一步的认识，因此写下此教程，供有需要者查阅。

与其他只演示操作的教程不同，此教程除了教你如何配置，还能一定程度上让你了解配置的目的是什么，防止你像无头苍蝇一样 —— 没有头 … … 额，到处乱撞。捣鼓半天后，气都气饱了。

---

首先理清楚几个问题：

问题1：为什么下载了 VScode 还要配置 C/C++ 所需要的环境？

• VScode只是一款代码文本编辑器，简单点说就是给你写代码的（比如记事本也行），它主要只是提供让你写的功能。但是我们知道编写完 C++ 代码后，还需要 对应的编译器（本文以 gcc/g++ 为例）对其进行编译，才能产生能让计算机执行的二进制文件。所以，需要进行环境配置——也就是下载 C++ 所需的编译器，再进行相关配置。

问题2：为什么有的 IDE 又不需要配置 C/C++ 所需要的环境？

• 上面也提到想要执行C++代码需要对应的编译器，所以这个问题也就清楚了，一些 IDE 在你下载时就已经为你下载并配置好了对应的编译器，所以不需要你单独下载并且进行相关配置（比如 VS、Dev-C++ 等）

如果嫌 VScode 配置繁琐，你可以选择上面提到的 IDE —— 一键“傻瓜式”安装。
本人比较喜欢 VScode，主要因为它轻巧、灵活。

问题3：为什么在配置的过程中需要将 “ g++ 所在的 bin 目录路径” 等 添加到环境变量中

• 首先当我们下载一个软件时，下载下来的是一堆文件夹。有的会有一个目录叫做 bin(binary)，这个文件夹下一般就会存放软件的入口 —— xx.exe。点击 xx.exe 就可以进入软件，使用其中的功能。(当然有的是通过指令进行调用)
• VScode 的编译 C++ 代码的功能是由 g++ 提供的，VScode 只是 调用 g++ 进行编译而已。但是它要找到 g++.exe 才能使用 g++，那它去哪里找？将你电脑里几百个G的磁盘文件全部翻一遍？当然不可能。所以需要将 “g++ 所在的 bin 目录路径” 添加到环境变量中。
• 环境变量相当于告诉系统当你在工作目录找不到 g++ 时，就去环境变量中的path中找。因此 VScode 在自己能识别的地方找不到 g++ 时，就会去环境变量中悄悄瞄一眼。有 g++.exe 所在的目录或者完整路径，nice，可以正常调用了；如果没有，啪地一下报错 —— 找不到 g++。 （所以这一步很重要，不然编译器你是下载了，但是 VScode 找不到，因此调用不了。就像手机收到快递到了的信息，结果去快递站找了半天找不到，你不得气死）

问题4：为什么配置后面阶段需要配置 .json 文件（tasks.json、launch.json 等）

• .json 可用于配置项目的各种属性 主要目的是给 VScode 提供相关信息，便于它做 编译、调试自动化（简单点就跟你使用各种软件中的设置差不多，只不过设置提供图形化界面便于操作，.json 需要你知道各种参数的含义才能正确配置）

我查阅过一些教程，VScode 的 .json 文件的配置 大多是直接扔他们自己的 .json 文件给你，让你直接复制。但是注意，那是适用于他自己的，不是我们，个体之间总会有差异，所以直接复制粘贴可能会出问题。那么是不是还需要特地去学习 .json 的配置呢？当然需要，额…打错字了，初学者可以不需要（当然如果你感兴趣也可以去了解，见作者的另外一篇文章 VScode的两个 json 文件）。VScode 官方文档里明确给出 .json 自动生成的方法，不需要我们手动配置，并且自动生成的也适用于我们自己。

---

VScode 官网其实是有 C/C++ 环境配置的官方文档的，只不过全英文，英文好的可自行查阅，或者使用翻译软件进行翻译。

建议还是多看一些英文文档（本人英语也一般，还是偶尔坚持查阅英文文档，看不懂就算了，还看的眼睛疼，所以还是放弃舒服啊），因为往后使用的很多软件基本上是外国的(谁叫我们起步晚呢)，文档自然而然也是英文

• 进入 VScode 官网（随便找了浏览器输入 VScode），然后如下点击即可进入官方文档
  
  【注】
• VScode、g++ 等工具的安装路径中不要包含中文，不然可能会出现一些莫名其妙的报错。

有的说用户名中文也会出问题，其实这也是上面的问题，因为有的工具默认安装路径在用户名（比如用户名是"帅的一批"）下，那么工具所在的路径就会包含中文用户名（如 “C:\user\帅的一批\VScode…”）。所以出现这个问题要么换个路径安装，要么修改用户名。

下面进入正题：

---

本教程 只针对 windows 系统，其余操作系统的请自行查询官网文档

在操作时请自行打开官方文档，本教程基于官方文档进行配置

1. VScode

---

1.1 VScode 安装

• 1. 点击 VScode

• 2. 选择 windows 操作系统，等待下载

• 3. 打开文件

• 4. 点击同意，然后下一步

• 5. 选择所要安装的路径，下一步

这里就是之前所说的不要有中文！！

注：选择安装在哪里都无所谓，你自己可以使用默认情况，我比较喜欢放在D盘中。如果你也像我一样，那么点击浏览，选择所要安装的目录，然后下一步。

• 6. 点下一步就行

• 7. 重点来了，全部勾选上，然后下一步

如果没有创建快捷方式的（即安装后桌面找不到 VScode 图标的），则去之前安装的目录下找 Code.exe 即可

• 8. 这里是之前的设置，看一遍没有问题就点击安装，有问题点击上一步重新设置

其实这些设置不用它提供的这个图形化界面也可以自己设置，只不过这种方式更方便

• 9. 完成，运行 VScode

• 10. 英文开始界面
      
• 11. 安装中文插件

英文不好的可以下载中文插件，重启 VScode 即可。如果不想下载也行，直接跳过

• 下载

VScode 的插件都是在这里安装的

• 点击右下角，软件自动重启，或者直接重启 VScode

• 进入中文界面

---

1.2 安装 C/C++ 插件

输入 C++，点击第一个安装。

插件叫 C/C++，这是推荐安装的，其功能不再介绍。其他插件根据需要自行安装。

第一部分完成，下面开始安装C++编译器了

---

2. MSYS2

MSYS2 是一个开源软件包集合（你可简单理解为手机的应用商店），其提供了类似于 Linux 的 shell 环境。输入对应的指令即可下载 C++编译器。

当然你也可以通过官网直接下载 C++编译器，直接下载的方法请自行查阅相关文档。下载后只需要添加环境变量即可，如何添加后面有相关教程，往后看

下面演示的是 VScode 官方文档提供的方法

---

2.1 MSYS2 安装

1. MSYS2 安装

• 在之前的 VScode 文档中往下滑一点，找到下面的地方，点击即可

• 但是我看了一下，官网的下载好像是接到 github（国外的网站）上，地处某个山卡卡都的我，下载固然慢的要死。如果你下载的快的话可以直接下载，不行的话去阿里云镜像网站搜索 MSYS2 下载
• 链接在这里：https://mirrors.aliyun/msys2/distrib/msys2-x86_64-latest.exe
• 这里不再演示，网上有许多教程，阿里官网也说的很清晰。注意下载的是msys-x86_64.exe，点击下载即可。 -latest 说明是最新版本

2. 点击打开文件

3. 进入安装向导，下一步

4. 选择安装路径

注意：安装路径虽然可以随便换，但是 建议使用默认目录，避免安装失败

5. 剩余的都是一直下一步即可，点击安装，不再演示

【注意】可能会一直卡在50%，不知道什么原因，但我在查资料找原因的时候，突然就100%了…
【总结】-_- 耐心等待… 当然你可以用祖传方法 —— 敲一敲电脑，没准一下就ok了（开个玩笑）

---

2.2 下载编译器

• 运行后进入

• 如果没进入的话，去安装路径的首文件夹下会有 msys2.exe，双击运行即可

• 这个工具的粘贴为 “右键 + 点击 Paste”

---

• 在这个黑框中输入下面的咒语，然后回车键enter

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

• 默认全部下载，直接 enter 即可

此工具链包含了 GCC编译器(gcc、g++) 与 gdb调试器等

• 在 Proceed with installation? [Y/n] 处输入 y，点击enter，等待下载

• 完成，关闭软件

---

• 2.3 重点：将编译器所在目录加入环境变量中

如果你安装 MSYS2 使用了默认路径，那么加入环境变量的 PATH 的路径就是 C:\msys64\ucrt64\bin。如果你是自定义路径，请在安装目录下找到 ucrt64 文件夹中的 bin 文件夹。将 bin目录 对应的路径加入环境变量。

• 其实你打开 C:\msys64\ucrt64\bin目录，你会发现之前所说的所需要的编译工具都在里面，如 g++.exe、gcc.exe(gdb.exe为调试工具），所以这也是为什么将此 bin目录 加入环境变量。
• 换言之，你可以直接加入 C:\msys64\ucrt64\bin\gcc.exe（g++.exe、dbg.exe也一样）到环境变量中，但是这样比较麻烦，所以直接加入他们共同的上一级目录即可

• 1. 找到 安装目录下找到 ucrt64 文件夹中的 bin 文件夹，复制路径

有的可能在 mingw64 文件夹中的 bin 文件夹下，你自己点开两个文件夹，看其中的 bin 文件加下哪个有下面图片中的 .exe，这里的路径就是哪个

• 2. 右键此电脑，点击属性

• 搜索环境变量，点击编辑账户的环境变量

编辑系统环境变量也行，区别在哪请自行查阅相关资料

• 点击Path，点击编辑

• 点击新建，将之前的路径复制上去，点击确定即可。

• 点击确定

【注意】点击确定，要不然不生效!!!

• 双击Path，进入Path

• 确保已经生效

有的就是没有点击确定，导致环境变量未加入成功，导致之后各种报错，找不到 gcc、g++ 等

---

2.4 验证是否成功将 gcc、g++、gdb 加入环境变量

这一步必须成功，否则之后的配置也是白费

• 如果未成功的首先去查看环境变量是否生效
• 如果环境变量生效的，则去看之前遗漏了什么步骤，哪个步骤错了，路径是否有中文等

1. 打开 CMD 或者 PowerShell，点击 enter 进入交互界面

win + R 快捷键，输出 cmd 或者 powershell，点击 enter
win键 就是键盘左下角最先面一排第三个键，带有4个矩形图案的那个键，不同键盘可能有点差异，不知道的自行百度

2. 依次输入下面三条指令，输入一条就按一次enter：

gcc --version
g++ --version
gdb --version
注： gcc 与 --version 之间有空格，其他的也是
出现对应的版本号说明成功了
如果没有成功，请查看环境变量是否加入成功

是不是感觉步骤很多，其实你熟悉后也就四个步骤：

• 下载 VScode
• 在 VScode 中下载 C/C++ 插件
• 下载 C++编译器 （相较于其他不同的是此教程从 MSYS2 中下载编译器，其他是直接从官网下载）
• 将下载的编译器对应的路径加入环境变量中

---

3. VScode 配置 .json

还是再提醒一遍：

• 不需要复制其他人提供的 .json 文件，自己按照下面步骤进行即可，VScode 自动生成合适你自己的 .json 文件
• 下面新建的文件夹和文件的名称使用英文，别用中文**（哪天出现莫名其妙的报错先查看路径中是否有中文）**

此步骤的目标，自动生成以下三个 .json 文件：

• tasks.json
• launch.json
• c_cpp_properties.json

---

1. tasks.json

• 1. 打开VScode

打开的文件夹必须是已经存在的，此文件夹用于存放你写的代码
所以在此之前，你需要创建一个空文件夹，用于存放代码

• 比如我这里创建的是 D:\2.code\VScode\text 这个空文件夹，你可在任意想要的地方创建一个空文件夹
  

• 2. 点击打开文件夹，找到之前创建的空文件夹，点击选择文件夹
     

• 进入了 text 文件夹（英文是大写的，估计 VScode 默认根文件夹是大写字母）

• 3. 创建新文件
• 点击下面的图标，你将鼠标悬停在图标上会显示对应的功能，比如此图标是用于新建文件的

• 新建文件，在这里输入文件名

• 我这里创建叫 hello.cpp 的文件，在文件中输入代码，懒得写的直接copy下面的代码

// 每个敲代码的入门的经典程序-_-
#include <iostream>

using namespace std;

int main()
{
    cout << "hello world" << endl;
    return 0;
}

• 4. 运行代码
• 先点击 三角形旁边 的 下箭头，再点击运行，别点错了

• 会弹出下面的界面

选择 g++，不是 gcc，位置可能不同，但是选的是 g++ (gcc 与 g++ 的区别自行查阅其他资料)

• 成功运行

• 点击终端，出现 hello world，说明成功了，同时会在 hello.cpp 下生成了hello.exe

• 同时资源管理器处自动出现了 .vscode 文件夹，点击可以看到 tasks.json 已经自动生成

• 你也可以对程序设置断点，进行调试，这里不演示

---

2. launch.json

• 按照下面依次点击

注意是 g++

• 会弹出以下界面

launch.json自动创建成功

---

3. c_cpp_properties.json

• 1. 进入配置界面
• 使用快捷键 Ctrl + Shift + P，弹出下面的界面，在搜索框中输入 C/C++，点击下面的 C/C++:编辑配置 (UI)

• 进入配置界面

• 2. 进行相关配置

你需要修改三处配置

• 2.1 配置名称改为 GCC

• 点击添加配置

• 输出 GCC，点击确定

• 2.2 添加 编译器路径
• 找到之前安装的 g++ 所在的目录

如果你之前使用默认路径安装的话，此路径应该是 C:\msys64\ucrt64\bin\g++.exe 或者 C:\msys64\mingw64\bin\g++.exe

• 将路径复制到下面展示的地方

• 2.3 修改 IntelliSense模式
• 下滑找到 IntelliSense模式
• 按照下面点击 2 所指的 下箭头，会出现下拉框
• 下滑下拉框，找到 gcc-x64 (legacy)，点击即可

• 此时 .vscode 文件夹下出现 c_cpp_properties.json

• 恭喜配置完成，差点累死我，肝了近一万字。

---

【注】

• .vscode 是 text 文件夹（之前创建那个）下的一个文件夹，其中有多个 .json 文件，用来存储相关配置信息，请勿删除。不小心删除了再重新按照上面的步骤配置即可
• 在 VScode 中，.vscode 文件夹通常用于存放工作区（此处演示的就是 text 文件夹，VScode 中的一种称呼而已）的相关配置文件，可以简单的认为：
  • 如果在 text 外重新创建一个文件夹（跟 text 文件夹创建方式一样），那么需要重新按照上面的步骤配置 .vscode 中的 .json
  • 如果在 text 下创建文件夹或文件，无特殊需求的可以不用重新配置

• 以上自动生成的 .json 对于初学者基本够用。但如果你有一些其他需求(比如用 VScode 写一个项目，有多个头文件，源文件，库文件…)或者想了解相关知识，可查看作者的另外一篇文章 VScode的两个 json 文件，文章对 tasks.json、launch.json 比较常用的地方做了相关介绍。
• 如果不想了解的，我这里简单说说自动生成的 .vscode 的作用：编译并运行当前你所打开的文件，因此要注意，它只能运行 C/C++ 文件，如果你当前打开不是 C/C++ 文件，运行后可能会报错
• 以上安装的所有文件，除非你清楚移动后应该更改哪些信息，否则别轻易移动位置，以免发生错误

---

如果你在安装的过程中出现无法解决的问题，欢迎留言，能解决的问题作者看到了会及时回复。

如果你发现本文的任何错误，欢迎指正。

写在后面

想想算了，不想写-_-

本文标签： 环境详细VSCode