头文件声明static函数并在C文件实现后出现“未使用函数”警告的问题排查求助

这个警告的核心问题出在你不该在头文件中声明static函数，这完全违背了static关键字的设计初衷。

为什么会触发警告？ #

static修饰的函数是编译单元（单个.c文件 + 它所包含的所有头文件）私有的——也就是说，每个包含了这个头文件的.c文件，都会独立生成一个SetLEDPort2Output函数的声明副本。

如果你的项目里还有其他.c文件包含了这个头文件，那么那个.c文件里就会存在一个没有实现、也没有被调用的static void SetLEDPort2Output(void);声明，编译器自然会抛出“unused function”警告。

哪怕你目前只有这一个.c文件用到这个头文件，这种写法也是不符合C语言规范的：头文件的作用是对外暴露接口，而static函数是文件内部的私有实现，不该放到头文件里对外“暴露”。

正确的写法应该是这样的 #

1. 移除头文件中的static函数声明，头文件里只保留对外公开的接口（比如你的LEDPortIni函数）：

// 头文件内容
void LEDPortIni(void);

2. 在实现的.c文件内部声明并实现static函数，两种常见写法都可以：

// .c文件内容
// 写法1：先声明再实现
static void SetLEDPort2Output(void);

static void SetLEDPort2Output(void) {
    for(int i = 0;i < 7;i++) {
        LEDPort.aGPIO[i]->CRL &= ~(0x0Fu<<(4*LEDPort.aPIN[i]));
        LEDPort.aGPIO[i]->CRL |= (0x01<<(4*LEDPort.aPIN[i]));
    }
}

// 写法2：直接用static修饰实现（更简洁，无需单独声明）
/*
static void SetLEDPort2Output(void) {
    for(int i = 0;i < 7;i++) {
        LEDPort.aGPIO[i]->CRL &= ~(0x0Fu<<(4*LEDPort.aPIN[i]));
        LEDPort.aGPIO[i]->CRL |= (0x01<<(4*LEDPort.aPIN[i]));
    }
}
*/

void LEDPortIni(void) {
    RCC->APB2ENR |= 0x1<<2;
    SetLEDPort2Output();
}

这样一来，SetLEDPort2Output就只会属于这个.c文件的私有函数，不会被其他编译单元看到，自然也就不会触发未使用的警告了。

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