clangd 15.0.7误报empty-translation-unit警告求助

问题背景 #

在Windows 11和macOS 13.2的VSCode环境中使用clangd 15.0.7时，minmax.h头文件被触发ISO C requires a translation unit to contain at least one declaration（对应警告选项-Wempty-translation-unit），但项目实际使用的gcc 11.3.0编译器并未抛出任何警告。

尝试过在.clangd配置中用Remove: [-Wempty-translation-unit]消除警告，但由于-Wall和-pedantic会隐式开启该警告，此配置无法生效。

相关代码文件 #

minmax.h #

#ifndef _KPPV_MATH_H_
#define _KPPV_MATH_H_

unsigned int min( unsigned int left, unsigned int right ); /* ISO C requires a translation unit to contain at least one declarationclang(-Wempty-translation-unit) */

unsigned int max( unsigned int left, unsigned int right );

#endif

minmax.c #

#include "minmax.h"

unsigned int min( unsigned int left, unsigned int right ) {
    return left < right ? left : right;
}

unsigned int max( unsigned int left, unsigned int right ) {
    return left > right ? left : right;
}

无效的.clangd配置示例 #

CompileFlags:
    Add: [-W, -Wall, -pedantic, -xc, -std=c89, ]
    Remove: [-Wempty-translation-unit]

注：因-Wall与-pedantic优先级更高，该Remove配置无法覆盖开启的警告，请勿再使用此方案。

可行解决方案 #

方案一：全局关闭警告（修改.clangd） #

直接在CompileFlags的Add列表中添加-Wno-empty-translation-unit，强制关闭该警告，配置如下：

CompileFlags:
    Add: [-W, -Wall, -pedantic, -xc, -std=c89, -Wno-empty-translation-unit]

原理：-Wno-xxx类型选项优先级高于对应的-Wxxx，可直接覆盖-Wall和-pedantic开启的警告。

方案二：仅针对头文件关闭警告（修改代码） #

在minmax.h中添加clang诊断指令，仅对当前头文件关闭该警告，不影响其他代码检查：

#ifndef _KPPV_MATH_H_
#define _KPPV_MATH_H_

#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wempty-translation-unit"

unsigned int min( unsigned int left, unsigned int right );
unsigned int max( unsigned int left, unsigned int right );

#pragma clang diagnostic pop

#endif

这种方式更精准，不会全局关闭该警告，适合仅单个头文件出现问题的场景。

内容的提问来源于stack exchange，提问作者Ter Maxima