NotePublic/Software/Applications/VSCode/VSCode_使用_Clangd_插件.md

# VSCode 使用 Clangd 插件

安装 clangd (LLVM) 插件。

使用 .clangd 或 .vscode/settings.json 进行项目配置。

## .clangd

通过：

```bash
Ctrl+Shift+P -> clangd: open project configuration file
```

打开项目 .clangd 文件， 参考格式如下：

```clangd
CompileFlags:
    Add:
        - -xc
        - -ID:/Path/to/project/source/User
    Remove:
        - -forward-unknown-to-host-compiler
        - --generate-code*
        - -rdc=*
        - -Xcompiler*
```

其中 -x 为 gcc 参数，用于忽略源代码文件扩展名，并使用 -x 参数指定的语言类型。如果源码文件不是标准后缀名称（.c，.cpp ）或语法与扩展名不符，则 gcc 编译器便不能通过后缀名判断语言类型，此时可以通过该参数指定语言类型。取值可以为：

- -xc
- -xc++
- -xobjective-c
- -xc-header
- -xcpp-output
- -assembler
- -assembler-with-cpp

-I 为 gcc 指定库头文件路径的参数。

## .vscode/settings.json

创建：.vscode/settings.json 文件，参考配置格式如下：

```json
{
    "clangd.fallbackFlags": [
        "-xc",
        "-I${workspaceFolder}/User",
      ],
}
```

## clang 参数

- -xc: 使用 C 文件；
- -xc++： 使用 C++ 文件。