VS Code C\C++ 环境搭建 踩坑日记

前言

是的，我原来一直用的是一个野生 IDE （小熊猫 Dev C++）。就是图一个一键安装，够用就完事儿了，不像 VS Code 配置极其烦人。

但是吧，VS Code 的内建 Git 支持，云同步，多语言支持，无敌拓展性等等等等东西。这也太香了！！

所以呢，写一篇这个博客来记录一下我痛苦的配置流程，权当一篇学习笔记。也是为了我自己以后在新环境配置的时候能有一个资料用以参考。

本文中的所有配置都是在 Windows 环境下完成。仅供参考。

网络上的资料水准真的都太参差不齐了。甚至我看到的一部分资料放到现在已经完全失效。

幸运的是，我最终还是找到了一个靠谱的资料来源。

VS Code 官网上的 Documentation，虽然都是英文的，但是微软背书，保证靠谱。

强烈推荐去看官方的文档！！

Visual Studio Code 内置变量定义

基本依赖

MinGW----Minimalist GNU for Windows

MinGW-w64 的安装可以自己去完善找包来安装，也可以通过管理平台来安装。

微软官方的 Documentation 里面使用的是 MSYS2 来管理 MinGW .

所以，我们用 MSYS2 来管理我们电脑中的 MinGW。

按照官网的操作来。

安装

打开安装包，一路下一步。

配置

更新包列表

打开 MSYS2 的 bash，输入如下命令更新包。

pacman -Syu
pacman -Su

选择包

输入一下命令，获取 MinGW64 的所有包的列表。

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

你会看到这样的输出 （我的输出会少一些，因为我已经安装过了）

:: There are 10 members in group mingw-w64-x86_64-toolchain:
:: Repository mingw64
   1) mingw-w64-x86_64-gcc-ada  2) mingw-w64-x86_64-gcc-fortran
   3) mingw-w64-x86_64-gcc-libgfortran  4) mingw-w64-x86_64-gcc-objc
   5) mingw-w64-x86_64-gdb-multiarch  6) mingw-w64-x86_64-libgccjit
   7) mingw-w64-x86_64-libmangle-git  8) mingw-w64-x86_64-pkgconf
   9) mingw-w64-x86_64-tools-git  10) mingw-w64-x86_64-winstorecompat-git

依次选择 mingw-w64-x86_64-gcc，mingw-w64-x86_64-make，mingw-w64-x86_64-gdb（调试工具）。

等待联网下载安装，速度慢可以换镜像源或者挂个梯子。

添加环境变量

在 环境变量-系统变量-Path 中添加一条新的路径

C:\msys64\mingw64\bin（默认路径，可根据本机情况设置）

重启 VS Code。若工作目录下无任何配置，VS Code 会自动识别到 MinGW 的位置。

CMake----自动生成 C/C++ Makefile

在第二次寒假作业中，需要用到多文件编译。VS Code 并未集成该功能，需要我们手动配置一下。

打开 CMake 的官网，找到 Windows 的安装包下载并安装。

安装的时候勾上 添加到系统变量 。

更多内容可以参考，CMake 入门实战 | HaHack

VS Code 插件

到 VS Code 的插件市场里面找到如下插件并安装。

• 微软自带的 C\C++ 包装上
• Code Runner （单文件直接用这个编译运行就好了，省事）
• CMake
• CMake Tools
• (可选) C/C++ Project Generator [替代 CMake，直接生成 Makefile，不太好用]

配置 VS Code

所有配置工作完成了之后记得登录微软账号，同步全局设置。

下次就不用在调试了，直接登陆，一键同步就好了。

多文件编译

多文件编译完全可以参考微软官方关于 CMake 配置的文档 Get started with CMake Tools on Linux。

虽然是适用于 Linux 平台的文档，但是 Windows 下也是完全适用的。

没有中文就是了，全英文的看着有点点费劲。

简要记录一下关键步骤。

• 将 CMake Generator 设置为 MinGW。

• 修改 CMakefile

  CMakefile 的默认设置下是不会自动关联文件夹内的所有文件的。

  要实现这一点需要再 CMakefile 中加入以下内容。

aux_source_directory(. DIR_SRCS)
add_executable(projectname ${DIR_SRCS})

还有，如果要打开编译器的所有警告要加入以下内容

add_compile_options(-Wall -Wextra)

为什么使用 CMake

照理来说，在 Linux中，一般 C/C++ 项目的编译是依赖于 make 程序 读取 Makefile 来实现的.

但是呢，每个项目都自己写 Makefile 比较麻烦，并且这里还有一个学习门槛。

于是乎，CMake工具诞生了。CMake 工具能够为我们大幅度简化编写 Makefile 的这一步骤，通过 CMakeLists.txt 这个文件为我们自动生成 Makefile，实现多文件编译的半自动化。

此外，CMake 还可以为我们提供不同 IDE 之间工程文件的转换，提供跨平台编译 C/C++ 项目的特性。

GCC G++的区别

在编译运行源代码的时候，VS Code 会弹出一个窗口让你选择使用那个编译器。gcc 和 g++ 就在供你选择的列表当中。这个要怎么选择呢？

先说结论，gcc 和 g++ 是两个不同的东西。

一般来说，在编译 C 语言程序的时候使用 gcc

在编译 C++ 语言程序的时候使用 g++

Reference

我遇到的问题

看不到返回值

在 Dev C++ 中，通过 Dev C++ 运行的程序都能够显示出程序的返回值和程序运行时间。而在 VS Code 中则没有这个显示。

可以从 Dev C++ 里面扣一个 ConsolePauser.exe 出来，用他来运行编译出来的 exe 文件可以捕获到程序的返回值。

参考 ConsolePauser 的帮助提示。

Usage: ConsolePauser.exe <0|1>

1 means the STDIN is redirected by Dev-CPP;0 means not

修改 Code Runner 的设置，加到全局设置里面去。

    "code-runner.executorMap": {
		// ...
        "c": "cd $dir && gcc $fileName -o $fileNameWithoutExt && ConsolePauser 0 $dir$fileNameWithoutExt",
        "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt && ConsolePauser 0 $dir$fileNameWithoutExt",
        "objective-c": "cd $dir && gcc -framework Cocoa $fileName -o $fileNameWithoutExt && ConsolePauser 0 $dir$fileNameWithoutExt",
        // ...

    }

配置完成之后，透过 Code Runner 运行的 C/C++ 程序就能够显示程序返回值。

PS D:\Projects\Codes\programming-daily> cd "Your dir" ; if ($?) { gcc hello.c -o hello } ; if ($?) { ConsolePauser 0 .\hello }

Hello, world!
--------------------------------
Process exited after 0.02 seconds with return value 666

编译选项全部开开

因为之前在 小熊猫 Dev C++ 里面报错提示就很非常细致。

若要打开编译器的全部提示以及额外提示，需要在编一下选项中添加如下参数

--Wall，--Wextra。

W 表示 Warning

（后来在 C++ Primer里面也看到了推荐打开这个选项的提示）

中文代码显示问题

在 VS Code 中，打开含有中文内容的源码全部都会变成乱码。

若要恢复中文内容在编辑器中的正常显示，需要在 VS Code 的右下角找到 UTF-8 （默认）选择 通过编码打开 并将编码改为 GBK 或 GB18030，结束。

调试中文乱码问题

发现透过 gdb 运行的程序 中文显示会乱码。

推测原因: Powershell 和 gdb 显示的编码不同。

一个小窍门，别写中文代码。治标又治本。