vscode 中clangd警告消除和头文件多级包含问题

violet872

使用vscode编写代码，clangd格式化和函数跳转等功能，但是clangd插件报错 Included header FreeRTOS.h is not used directly (fixes available)这种未使用的头文件，实际是有用的，应为没有直接在当前.c文件中使用。比如在bsp.h中包含各种驱动文件，main.c中使用，然后bsp.h就会报很多这个错。请教下大家这个怎么解决啊，DS给出的方案是添加UnusedIncludes: Ignore，但是实测没有什么用

eric2013

帮顶。

forever_ming_

我写了一个python脚本用来处理keil工程，在vscode环境下使用clangd插件能够根据keil的工程信息建立clangd索引信息的compile_commands.json文件，可以使用这个文件完成精确函数查找跳转，当然c++插件也可以使用这个文件，原理就是解析keil的工程文件生成对应的查找规则，代码开源在GitHub，不喜欢python可以使用我release打包的exe版本，放在环境变量路径下可以通过命令生成文件就能直接解析了，https://github.com/huiyi-li/keil2clangd

forever_ming_

但是我觉得使用跳转正常的话，头文件解析使用的头文件未使用也正常吧。

arcbishopw

不是哥们，看标题还以为问题解决了，我现在也遇到这个问题

Joia

有没有知道打开两个文件夹，点击出现另外一个文件的定义。怎么解决啊。。。

Joia

https://github.com/rizsotto/Bear 这个工具完美解决

Joia

Joia 发表于 2025-11-13 10:11
https://github.com/rizsotto/Bear 这个工具完美解决

还是会出现部分函数跳转出现弹窗

wdliming

forever_ming_ 发表于 2025-6-26 19:03
我写了一个python脚本用来处理keil工程，在vscode环境下使用clangd插件能够根据keil的工程信息建立clangd索 ...

尝试过，不是特别完美。。

forever_ming_

wdliming 发表于 2025-11-13 11:15
尝试过，不是特别完美。。

有意见欢迎提issue

wdliming

forever_ming_ 发表于 2025-11-22 15:38
有意见欢迎提issue

github没账号，弄了半天也没弄成功。gitee的话我倒是可以。

xbin

在项目路径下添加 `.clangd` 文件，然后输入下面内容是否有效？
```yaml
Diagnostics:
  Suppress: [unused-includes]
```

会飞的猪_2020

wdliming 发表于 2025-11-13 11:15
尝试过，不是特别完美。。

tools.7z (6.05 KB, 下载次数: 2)

2026-1-9 16:38 上传

点击文件名下载附件

我也整过一个

xbin

会飞的猪_2020 发表于 2026-1-9 16:38
我也整过一个

```py
# 注意：这里使用默认的编译器名称，实际使用时会被clangd的--query-driver覆盖
compiler: str = "armcc"
```

使用 armcc 出现下面问题，无法跳转，需要改成 arm-none-eabi-gcc 才行
上面说的 --query-driver 是什么，我 vscode 中的 query-driver 是 --query-driver=**

+ Too many errors emitted, stopping now
+ 'main.h' file not found

会飞的猪_2020

xbin 发表于 2026-1-10 07:51
```py
# 注意：这里使用默认的编译器名称，实际使用时会被clangd的--query-driver覆盖
compiler: str = ...

你如果用clangd进行代码提示的的话：

[C] 纯文本查看 复制代码

{
    "clangd.onConfigChanged": "restart",
    "clangd.arguments": [
        "--clang-tidy",
        // 允许 clangd 调用 Keil 的 armclang 编译器去查询系统路径
        "--query-driver=C:/Users/w1545/AppData/Local/Keil_v5/ARM/ARMCLANG/bin/armclang",
        "--compile-commands-dir=${workspaceFolder}/build",
    ],
}

--compile-commands-dir 这个是生成json的文件夹.
--query-driver这个是编译器的路径
（因为有些宏定义是编译器提供的，例如编译器版本之类的，clangd需要知道）

然后你在目录下新建一个.clangd文件，在里面加入这些，mcpu根据你实际的芯片填写.

[C] 纯文本查看 复制代码

CompileFlags:
  Add:
    - "--target=arm-none-eabi"
    - "-mcpu=cortex-m3"
    - "-mthumb"
    - "-xc"
    - "-std=c11"
    - "-IC:/Users/w1545/AppData/Local/Keil_v5/ARM/ARMCLANG/include"
Diagnostics:
  UnusedIncludes: None

xbin

.clangd 配置 Compiler 后正常了

[C] 纯文本查看 复制代码

CompileFlags:
    Compiler: arm-none-eabi-gcc

但是在 CMSIS/core_cm4.h 文件中看到错误：

+ Use of undeclared identifier '__NVIC_PRIO_BITS' (fix available)clang(undeclared_var_use)
+ Unknown type name 'IRQn_Type' (fix available)

快速修复的建议是：在 CMSIS/core_cm4.h 文件头添加 #include "gd32f30x.h"
这种有办法配置吗，现在已经够用了，其实这种无所谓

[C] 纯文本查看 复制代码

/** \brief  Decode Priority

    The function decodes an interrupt priority value with a given priority group to
    preemptive priority value and subpriority value.
    In case of a conflict between priority grouping and available
    priority bits (__NVIC_PRIO_BITS) the samllest possible priority group is set.

    \param [in]         Priority   Priority value, which can be retrieved with the function \ref NVIC_GetPriority().
    \param [in]     PriorityGroup  Used priority group.
    \param [out] pPreemptPriority  Preemptive priority value (starting from 0).
    \param [out]     pSubPriority  Subpriority value (starting from 0).
*/
__STATIC_INLINE void NVIC_DecodePriority (uint32_t Priority, uint32_t PriorityGroup, uint32_t* pPreemptPriority, uint32_t* pSubPriority)
{
  uint32_t PriorityGroupTmp = (PriorityGroup & 0x07);          /* only values 0..7 are used          */
  uint32_t PreemptPriorityBits;
  uint32_t SubPriorityBits;

  PreemptPriorityBits = ((7 - PriorityGroupTmp) > __NVIC_PRIO_BITS) ? __NVIC_PRIO_BITS : 7 - PriorityGroupTmp;
  SubPriorityBits     = ((PriorityGroupTmp + __NVIC_PRIO_BITS) < 7) ? 0 : PriorityGroupTmp - 7 + __NVIC_PRIO_BITS;

  *pPreemptPriority = (Priority >> SubPriorityBits) & ((1 << (PreemptPriorityBits)) - 1);
  *pSubPriority     = (Priority                   ) & ((1 << (SubPriorityBits    )) - 1);
}

会飞的猪_2020

xbin 发表于 2026-1-14 09:37
.clangd 配置 Compiler 后正常了

[mw_shl_code=c,true]

你这个问题我没遇到过。我按照上一楼这样配置之后，就可以正常使用跳转了。