Cpp VSCode 配置

记录一下VSCode配置C++的内容吧。

插件列表

首先列一下目前在VSCode上使用的，涉及到C++的核心插件：

C/C++ (Microsoft)：微软官方默认的C/C++插件，禁用了代码提示，但是调试这些还需要用它，不能完全禁用
clangd (LLVM)：LLVM官方提供的，当前代码提示的主力插件
CMake Tools (Microsoft)：微软官方提供的CMake支持，提供CMake命令工具条和快捷指令，以及CMake语法高亮
CodeLLDB (Vadim Chugunov)：lldb调试支持，非官方支持

还有两个不太重要的插件：

C/C++ Themes (Microsoft)
Better C++ Syntax (Jeff Hykin)

补充：通过clangd (LLVM) 插件安装的clangd虽然是最新版本，但是代码修正功能可能有问题，还是直接使用系统中的clangd更加可靠。

C/C++ 插件和 clangd 插件配置

主要的内容是禁用默认C/C++插件的主要功能，然后用clangd以及对应插件替换掉，并对clangd进行配置。

//**************************************************************************//
//[[C++]]
// 关闭默认C/C++插件的格式化 C_Cpp.formatting
"C_Cpp.formatting": "disabled",
// 关闭默认C/C++插件的智能提示 C_Cpp.intelliSenseEngine
"C_Cpp.intelliSenseEngine": "disabled",
// 关闭默认C/C++插件的自动补全 C_Cpp.autocomplete
"C_Cpp.autocomplete": "disabled",
// 关闭默认C/C++插件的错误曲线 C_Cpp.errorSquiggles
"C_Cpp.errorSquiggles": "disabled",
// 关闭默认C/C++插件的自动代码分析 C_Cpp.codeAnalysis.runAutomatically
"C_Cpp.codeAnalysis.runAutomatically": false,
// C/C++的默认配置由cmaketools提供 C_Cpp.default.configurationProvider
"C_Cpp.default.configurationProvider": "ms-vscode.cmake-tools",
// clangd的分析参数 clangd.arguments
"clangd.arguments": [
    "--completion-style=detailed",
    "--clang-tidy",
    "--background-index",
    "--enable-config",
    "--header-insertion=never",
    "--header-insertion-decorators",
    "--fallback-style=LLVM",
    // "--fallback-style=WebKit" 4缩进
],
// clangd在没有找到编译指令文件时基于如下编译指令进行静态分析 clangd.fallbackFlags
"clangd.fallbackFlags": [
    "-I${workspaceFolder}",
    "-I${workspaceFolder}/include",
    "-fsanitize=address",
    "-fsanitize=undefined",
    "-Wall",
    "-Wextra",
    "-Wshadow",
    "-Wfatal-errors",
    "-Wno-unused-variable",
    "-Wno-unused-parameter"
],
// clangd自动检测插件冲突 clangd.detectExtensionConflicts
"clangd.detectExtensionConflicts": true,
"clangd.checkUpdates": true,

CMaketools 插件配置

对CMake提供支持的插件配置。

//**************************************************************************//
//[[cmake]]
// cmake关闭自动配置 cmake.autoSelectActiveFolder
"cmake.autoSelectActiveFolder": false,
// cmake关闭在打开时自动配置 cmake.configureOnOpen
"cmake.configureOnOpen": false,
// cmake关闭在编辑时自动配置 cmake.configureOnEdit
"cmake.configureOnEdit": false,
// cmake状态条可见性 cmake.options.statusBarVisibility
"cmake.options.statusBarVisibility": "compact",
"cmake.options.advanced": {
    "cpack": {
        "statusBarVisibility": "hidden"
    },
    "workflow": {
        "statusBarVisibility": "hidden"
    },
    "debug": {
        "statusBarVisibility": "hidden"
    },
    "ctest": {
        "statusBarVisibility": "icon"
    }
},
"cmake.preferredGenerators": [
    "Ninja"
],
"cmake.pinnedCommands": [
    "cmake.configure",
    "cmake.build",
    "cmake.cleanConfigure",
    "cmake.selectKit",
    "cmake.setVariant",
    "cmake.showConfigureCommand"
],
"cmake.showOptionsMovedNotification": false,

如果CMakeLists.json插件在识别编译工具链时出现错误，可以手动修改下面的配置文件，或者直接删除，让它重新扫描配置

在Windows中，配置文件位于~/AppData/Local/CMakeTools/cmake-tools-kits.json
在WSL2中，配置文件位于~/.local/share/CMakeTools/cmake-tools-kits.json

C++ 调试配置

下面的部分是关于CMake项目调试的配置，早期这种配置必须存放在项目的.vscode/launch.json文件中，现在已经支持在settings.json中添加默认配置了。

这三种配置使用的调试器分别是：

lldb
gdb
vsdbg

分别对应与clang，gcc和MSVC。

用它们调试对应的编译器得到的可执行程序通常是没问题的，但是混用是很可能有问题的，在Windows上

vsdbg可以调试target是MSVC的clang得到的可执行文件
vsdbg不支持调试gcc+MinGW或clang+MinGW得到的可执行文件
lldb可能可以替代gdb

//**************************************************************************//
//[[launch]]
// 默认的launch设置，搭配cmake和gdb/lldb使用，不需要单独的launch.json
"launch": {
    "configurations": [
        {
            "name": "lldb(CMake)",
            "type": "lldb",
            "request": "launch",
            "program": "${command:cmake.launchTargetPath}",
            "args": [],
            "cwd": "${workspaceFolder}",
            "console": "integratedTerminal"
        },
        {
            "name": "gdb(CMake)",
            "type": "cppdbg",
            "request": "launch",
            "program": "${command:cmake.launchTargetPath}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [
                {
                    "name": "PATH",
                    "value": "${env:PATH}:${command:cmake.getLaunchTargetDirectory}"
                }
            ],
            "externalConsole": false,
            "MIMode": "gdb",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "miDebuggerArgs": "-q -ex quit; wait() { fg >/dev/null; }; /usr/bin/gdb -q --interpreter=mi"
        },
        {
            "name": "vsdbg(CMake)",
            "type": "cppvsdbg",
            "request": "launch",
            "program": "${command:cmake.launchTargetPath}",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [
                {
                    "name": "PATH",
                    "value": "${env:PATH}:${command:cmake.getLaunchTargetDirectory}"
                }
            ],
            "console": "externalTerminal"
        }
    ],
    "compounds": []
},

clangd 配置

这里的clangd指的是专门的软件（通常在下载clang时附带下载），并不是VScode插件，关于clangd主要有三种配置文件：

.clangd：主配置文件；
.clangd-tidy：关于C++静态检查的配置文件；
.clangd-format：关于C++格式化检查的配置文件；

.clangd

clangd有时候比较蠢，我们可以通过在项目根目录添加.clangd配置文件来协助，例如它很可能在Windows上找不到正确的标准库头文件，而是会跳转到MSVC的标准库头文件，我们可以添加--include-directory=来指定。

.clangd 示例如下

CompileFlags:
  Add:
    - '-Wall'
    - '-Wextra'
    - '-Wshadow'
    - '-Wno-unused-parameter'
    - '-std=c++17'
    - '--include-directory=/path/to/compiler/include'

有时候需要使用C语言项目，但是默认的配置是针对C++的，对于C语言项目可以使用下面的配置，重点是-xc选项

CompileFlags:
  Remove: [-std=*]
  Add: [-xc, -Wall]
  Compiler: clang
Diagnostics:
  ClangTidy:
    Remove: readability-identifier-naming

除此之外，clangd主要会基于compile_commands.json文件进行代码提示，CMake项目可以用特定选项在build/中自动生成compile_commands.json。

clangd 对于头文件的分析有时候很愚蠢，非要警告某些头文件没有被当前的文件实际使用，但是它其实有特别的用途（比如导出接口，或者就是clangd没有分析出来），真正将其移除又会导致编译失败，此时可以使用下面的注释来关闭对应警告（IWYU：include-what-you-use），参考官方文档

1 2	#include "a.h" #include "b.h" // IWYU pragma: keep

.clang-tidy

clang-tidy可以提供C++的静态语法检查，包括很多具体规则的检查（有的检查过于严格了，不能全部开启），通过.clang-tidy配置文件设置。

可以使用如下的注释去关闭特定位置的特定检查

关闭当前行的所有检查 // NOLINT
关闭当前行的特定检查 // NOLINT(xxx)

关闭下一行的所有检查 // NOLINTNEXTLINE
关闭下一行的指定检查 // NOLINTNEXTLINE(xxx)

关闭一部分区域的全部检查
// NOLINTBEGIN(check-name)
...
// NOLINTEND(check-name)

关闭一部分区域的指定检查
// NOLINTBEGIN
...
// NOLINTEND

.clang-tidy 模板如下，具体含义可以参考clang官方文档。

Checks: 'bugprone-*,
-bugprone-easily-swappable-parameters,
cert-*,
-cert-env33-c,
-cert-dcl50-cpp,
-cert-err33-c,
clang-analyzer-*,
cppcoreguidelines-*,
-cppcoreguidelines-pro-bounds-array-to-pointer-decay,
-cppcoreguidelines-pro-bounds-pointer-arithmetic,
-cppcoreguidelines-pro-type-vararg,
-cppcoreguidelines-avoid-non-const-global-variables,
-cppcoreguidelines-avoid-const-or-ref-data-members,
-cppcoreguidelines-macro-usage,
-cppcoreguidelines-pro-type-cstyle-cast,
-cppcoreguidelines-owning-memory,
google-*,
-google-objc-*,
-google-readability-todo,
-google-readability-casting,
hicpp-*,
-hicpp-vararg,
llvm-*,
misc-*,
-misc-non-private-member-variables-in-classes,
-misc-unused-parameters,
-cppcoreguidelines-non-private-member-variables-in-classes,
modernize-*,
-modernize-loop-convert,
-modernize-use-nodiscard,
-modernize-use-trailing-return-type,
-modernize-avoid-c-arrays,
-cppcoreguidelines-avoid-c-arrays,
-hicpp-avoid-c-arrays,
mpi-*,
performance-*,
-performance-unnecessary-value-param,
-performance-enum-size,
readability-*,
readability-identifier-naming,
-readability-braces-around-statements,
-hicpp-braces-around-statements,
-google-readability-braces-around-statements,
-readability-identifier-length,
-readability-redundant-control-flow,
-readability-magic-numbers,
-cppcoreguidelines-avoid-magic-numbers,
-readability-const-return-type,
-readability-math-missing-parentheses,
fuchsia-default-arguments-declarations,
-misc-use-internal-linkage,
'

CheckOptions:
  - {key: readability-identifier-naming.MacroDefinitionCase, value: UPPER_CASE}
  - {key: readability-identifier-naming.NamespaceCase, value: lower_case}
  - {key: readability-identifier-naming.ClassCase, value: CamelCase}
  - {key: readability-identifier-naming.StructCase, value: CamelCase}
  - {key: readability-identifier-naming.EnumCase, value: CamelCase}
  - {key: readability-identifier-naming.TypedefCase, value: CamelCase}
  - {key: readability-identifier-naming.TypeAliasCase, value: CamelCase}
  - {key: readability-identifier-naming.TemplateParameterCase, value: CamelCase}
  - {key: readability-identifier-naming.ValueTemplateParameterCase, value: CamelCase}
  - {key: readability-identifier-naming.ParameterCase, value: aNy_CasE}
  - {key: readability-identifier-naming.MethodCase, value: lower_case}
  - {key: readability-identifier-naming.PublicMethodCase, value: aNy_CasE}
  - {key: readability-identifier-naming.MemberCase, value: lower_case}
  - {key: readability-identifier-naming.PublicMemberCase, value: aNy_CasE}
  - {key: readability-identifier-naming.PrivateMemberPrefix, value: m_}
  - {key: readability-identifier-naming.FunctionCase, value: aNy_CasE}
  - {key: readability-identifier-naming.VariableCase, value: aNy_CasE}
  - {key: readability-identifier-naming.ConstexprVariableCase, value: aNy_CasE}
  - {key: cppcoreguidelines-special-member-functions.AllowSoleDefaultDtor, value: true}
  - {key: cppcoreguidelines-special-member-functions.AllowMissingMoveFunctions, value: true}
  - {key: cppcoreguidelines-special-member-functions.AllowMissingMoveFunctionsWhenCopyIsDeleted, value: true}
  - {key: hicpp-special-member-functions.AllowSoleDefaultDtor, value: true}
  - {key: hicpp-special-member-functions.AllowMissingMoveFunctions, value: true}
  - {key: hicpp-special-member-functions.AllowMissingMoveFunctionsWhenCopyIsDeleted, value: true}
  - {key: readability-function-cognitive-complexity.IgnoreMacros, value: true}
  - {key: readability-function-cognitive-complexity.Threshold, value: 40}
  - {key: cppcoreguidelines-avoid-do-while.IgnoreMacros, value: true}
  - {key: hicpp-signed-bitwise.IgnorePositiveIntegerLiterals, value: true}

.clang-format

clang-format可以提供C++的代码格式化，包括很多具体规则的检查，需要通过.clang-format配置文件设置。

可以使用如下的注释去关闭特定位置的格式化

1
2
3

// clang-format off
...
// clang-format on

目前使用的 .clang-format 模板如下，更完整的内容可以参考clang官方文档。

---
Language: Cpp
BasedOnStyle: LLVM
AccessModifierOffset: -4
AllowShortBlocksOnASingleLine:  Always
AllowShortCaseLabelsOnASingleLine: true
AllowShortIfStatementsOnASingleLine: WithoutElse
AllowShortLoopsOnASingleLine: true
AlwaysBreakTemplateDeclarations: true

BreakBeforeBinaryOperators: NonAssignment
BreakBeforeBraces: Custom
BraceWrapping:
    AfterClass: false
    AfterControlStatement: Never
    AfterEnum: false
    AfterFunction: false
    AfterNamespace: false
    AfterStruct: false
    AfterUnion: false
    AfterExternBlock: false
    BeforeCatch: true
    BeforeElse: true
    IndentBraces: false
    SplitEmptyFunction: false
    SplitEmptyRecord: false
    SplitEmptyNamespace: true

KeepEmptyLinesAtTheStartOfBlocks: false
SeparateDefinitionBlocks: Always
SpacesBeforeTrailingComments: 2
IndentWidth: 4
TabWidth: 4
UseTab: Never
---

补充

必要软件

为了正常使用所有功能，除了针对VSCode的配置，至少还需要单独安装下列软件，并把路径添加到PATH

Git
CMake
ninja

vscode 快捷键

和 vim 类似，为了提高效率，有必要整理一下 vscode 常用的快捷键。(虽然 vscode 也支持 vim 模式，但是毕竟没有原始的快捷键体系方便)

两个最主要的：

ctrl+p 快速打开
- :n 转到第 n 行
- @symbol 查找并跳转到符号(对于 md 文件是各级目录)
- filename 打开当前文件夹的其他文件
ctrl+shift+p 快速打开命令面板(相当于快速打开后加上>继续输入命令)
ctrl+shift+o 快速打开符号查找(相当于快速打开后加上@继续输入命令)

主要操作

ctrl+, 进入设置的 GUI 界面
ctrl+shift+n 打开新的 vscode 窗口实例
ctrl+shift+m 显示问题界面
`ctrl+`` 显示或关闭集成终端界面
ctrl+shift+~ 显示集成终端界面并新建一个终端实例
ctrl+<enter>在下方插入一行，光标也随之移动
ctrl+shift+<enter>在上方插入一行，光标也随之移动(这个有很多快捷键冲突，可能没有用)

当前光标未选择内容时，复制剪切粘贴都是以当前行为单位进行的：

ctrl+c 复制当前行
ctrl+x 剪切当前行
ctrl+v 粘贴到当前行的前面

其他

ctrl+shift+k删除当前行
alt+up 把当前行上移
alt+down 把当前行下移
shift+alt+up 把当前行复制并插入到上方
shift+alt+down 把当前行复制并插入到下方