更新 MSYS2#

如果你在安装时一路”下一步”，安装完成后应该会自动启动 MSYS2 MSYS 终端。如果没有，请手动在开始菜单中找到 MSYS2 MSYS 程序并点击打开。

随后在终端内输入：

1
pacman -Syu

执行软件包更新，期间确认请输入 y。

验证安装#

1
clangd --version  # 显示版本即成功
2
where clangd      # 应显示路径而不是提示未找到文件
3
where g++         # 应显示路径而不是提示未找到文件

以下为正确安装后的输出截图（版本号可能随时间发展而变动，请以实际安装显示为准）：

配置环境变量#

将 C:\msys64\ucrt64\bin 添加到系统环境变量中。

TIP

若你在安装 MSYS2 时更改了安装路径，请自行将 C:\msys64 替换为你的实际安装路径。

Windows 系统下如何配置环境变量？

1. 按 Win + I 打开设置（或在开始菜单找到设置打开）；
2. 在左侧点击 “系统” ，右侧下滑到底部，点击 “系统信息” ；
3. 在 “设备规格” 区域 下方 找到 “高级系统设置” ；
   
4. 点击 “环境变量” → “系统变量” → “Path” ；
   
5. 点击 “浏览” ，或 “新建” ，将上述路径添加到 Path 中。

6. 点击 “确定” 保存设置。

验证环境变量：

在 Windows Terminal（终端）（CMD 或 PowerShell）中，执行：

1
clangd --version
2
g++ --version

正确配置后输出（版本号可能随时间发展而变动，请以实际安装显示为准）：

下载 VSCode#

前往 VSCode 官网下载网站：Download Visual Studio Code - Mac, Linux, Windows

根据 CPU 架构，下载 System Installer：

安装 VSCode#

双击安装包，若有 UAC 弹窗，请点击 “允许” 或 “是” 。

随后，一路”下一步”安装，根据自己磁盘与程序存储路径偏好，选择合适的安装路径，并请牢记。

安装时，推荐勾选以下选项（是否创建快捷方式请按个人需求勾选）：

安装并切换简体中文语言包#

观前提示

若具有一定的英语阅读能力，且无需更换程序语言为简体中文，可跳过此步。

搜索并安装：Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code 插件。

随后，点击 Change Language And Restart 按钮，VSCode 会自动重启并切换为简体中文。

安装 C/C++ 相关插件#

弹窗提示

安装过程中，若遇到 “是否信任发布者” 弹窗，请点击 “信任发布者并安装” 。

搜索并安装：C/C++、C/C++ Compile Run 插件。

搜索并安装：clangd、Clang-Format 插件。

配置相关插件#

关闭 IntelliSense#

首先，打开或新建任意 .cpp 后缀的文件，推荐写一个小程序，方便后续配置。

此时，通常情况下，clangd 插件会提示功能冲突，如下图：

请点击 Disable IntelliSense 按钮，关闭微软 C/C++ 插件的 IntelliSense 功能（代码自动补全、语法检查等），以避免与 clangd 冲突。

若错误点击，请依次点击以下按钮，打开 VSCode 用户设置（JSON）：

随后在文件末尾添加如下内容（请务必遵循 JSON 语法规范）：

1
"C_Cpp.intelliSenseEngine": "disabled"

TIP

若上一行有配置项，请在末尾加上 ,（英文半角逗号）。
如下图所示：

配置 Clang-Format 插件#

Clang-Format 插件是什么？

Clang-Format 是一款专用于 C/C++/Objective-C 等代码的自动格式化工具，可统一代码风格，提高可读性。

可以通过 “右键 → 格式化文档” 或按默认键盘快捷键 Shift + Alt + F 进行格式化操作。

初次操作，可能会出现如下弹窗，提示选择一个格式化程序：

点击 “配置”，选择 Clang-Format，如图所示：

随后，代码会被自动格式化。

若不喜欢默认的格式化风格，可前往 Clang-format configurator 网站，可视化定制自己喜欢的风格方案，生成相应的 .clang-format 文件。

将生成的 .clang-format 文件放置到一个固定的位置，推荐为用户主目录，如：C:\Users\SSJ_VMdemo\

注意

”SSJ_VMdemo” 是我在虚拟机中的用户名，请自行替换为你自己的用户名。若不清楚用户名，请前往 C:\Users\ 目录下查看。

随后，在 Clang-Format 插件设置中，指定格式化文件的绝对路径：file:C:/Users/SSJ_VMdemo/.clang-format。如下图：

最后，附上SSJ习惯的格式化风格文件，仅供参考：

1
# 基础风格
2
BasedOnStyle: LLVM
3

4
# 大括号风格
5
BreakBeforeBraces: Attach
6

7
# 宏对齐
8
AlignConsecutiveMacros: AcrossEmptyLinesAndComments
9

10
# 括号前的空格
11
SpaceBeforeParens: ControlStatements
12

13
# 赋值运算符前的空格
14
SpaceBeforeAssignmentOperators: true
15

16
# 最大空行数
17
MaxEmptyLinesToKeep: 1
18

19
# 尾部注释对齐
20
AlignTrailingComments: true
21
SpacesBeforeTrailingComments: 1
22

23
# 转义换行符对齐
24
AlignEscapedNewlines: Left
25

26
# 声明参数换行
27
AllowAllParametersOfDeclarationOnNextLine: true
28
BinPackParameters: true
29

30
# 缩进设置
31
UseTab: Never
32
TabWidth: 4
33
IndentWidth: 4

常见问题预案#

• 弹窗提示报错：The 'clangd' language server was not found on your PATH.
  • 解决方式一：检查是否正确配置环境变量；
  • 解决方式二：在 clangd 插件设置中，设置 clangd 可执行文件的绝对路径。如图所示：

• 打开 .cpp 文件，提示 fatal error: 'iostream' file not found 或其他头文件无法找到
  • 检查一：是否正确配置环境变量；
  • 检查二：是否按照本指南正确安装并配置 C/C++ 环境。

编译与运行 C/C++ 程序#

若按上述步骤正确配置后，可直接通过右上角按钮，一键编译与运行 C/C++ 程序（默认快捷键 F6），如图：

截图中的示例程序（供后续配置使用）：

1
#include <iostream>
2

3
int main(void) {
4
  std::string hello = {"Hello, VSCode!"};
5
  for (char c : hello) {
6
    std::cout << c;
7
  }
8
  std::cout << std::endl;
9
}

调试 C/C++ 程序#

调试前提示

调试前，请务必 添加（设置）断点 ！

若按上述步骤正确配置后，可直接通过右上角按钮进行调试（默认快捷键 F5），如图：

常见问题预案#

• 无法正常编译运行/调试程序

  • 检查一：是否正确配置环境变量；
  • 检查二：是否按照本指南正确安装并配置 C/C++ 环境。

• 对示例程序的疑问

  • 示例程序为何如此复杂？

    • 为演示后续调试功能，将简单的 Hello, VSCode 程序复杂化，其输出效果与直接打印相同。

  • 示例中的 for 循环为何与常见写法不同？

    • 使用了 C++11 引入的范围 for 循环（Range-based for loop），可缩减代码量，提高可读性。与下述传统写法功能一致：

    1
    #include <iostream>
    2
    
    3
    int main(void) {
    4
      std::string hello = "Hello, VSCode!";
    5
      for (std::string::iterator c = hello.begin(); c != hello.end(); c++) {
    6
        std::cout << *c;
    7
      }
    8
      std::cout << std::endl;
    9
    }
    

• 输出中文字符“乱码”：

  • 请在 C/C++ Compile Run 插件设置中，添加编译与运行的参数：-fexec-charset=GBK。如下图：
    

使用方法#

随后，在绝大多数 OJ 平台（如洛谷、LeetCode、Codeforces 等，不支持头歌平台），在开启 VSCode 并打开任意文件夹（推荐新建一个空文件夹存放相关文件）的前提下，点击浏览器插件的”加号”图标，即可将题目信息提取到 VSCode 中。

同时可通过该插件设置，配置默认的语言文件格式与模板，如将默认语言指定为 cpp ，指定新建文件的模板文件路径，如下图：

默认模板文件示例（仅供参考，可按自己需求修改）：

1
#include <iostream>
2

3
int main(void) {
4

5
}

使用方法#

使用前，请在侧边栏或按 Ctrl + Alt + G 再按 L，在 VSCode 内登录洛谷账号。

按 Ctrl + Shift + P 打开命令面板，输入 luogu 即可查看所有用法。

常用快捷键：

GitHub Theme#

项目 GitHub 地址：GitHub’s VS Code themes

SSJ个人很喜欢 GitHub Theme 插件提供的 GitHub Dark Colorblind (Beta) 样式主题。

One Dark Pro#

项目 GitHub 地址：Atom’s iconic One Dark theme for Visual Studio Code

也可以安装 One Dark Pro 插件，它提供的多款样式也十分美观。

控制字体大小#

• 配置名称：Editor: Font Size
• 设置值：16

Ctrl + 滚轮调整字体大小#

• 配置名称：Editor: Mouse Wheel Zoom
• 设置值：true

平滑光标移动动画#

• 配置名称：Editor: Cursor Smooth Caret Animation
• 设置值：on

平滑滚动#

• 配置名称：Editor: Smooth Scrolling
• 设置值：on

保存时自动格式化#

• 配置名称：Editor: Format On Save
• 设置值：on

粘贴后自动格式化#

• 配置名称：Editor: Format On Paste
• 设置值：on