C语言编译ARM目标时Pe177(static函数未引用)报错的解决方法

本次编译遇到的Error[Pe177]是ARM系列嵌入式编译器的代码规范检测报错——面向ARM ISA编译时，编译器会默认开启代码体积优化，对未被引用的静态函数的检测会比桌面端更严格，触发原因完全来自现有代码的写法问题：

1. file.c中前置声明的localFunc被static修饰，意味着该函数被限定为当前文件的内部函数，不会参与全局符号表导出，编译器会专门检测这类文件内部函数是否被实际使用；
2. 现有代码从函数声明、定义到extFunc的实现逻辑中，没有任何位置对localFunc发起调用；
3. 函数定义阶段遗漏了和前置声明匹配的static修饰符，进一步放大了编译器对存储类不匹配、未使用函数的检测敏感度。

对应修复方案 #

根据你对localFunc的实际使用规划，选择匹配的方案即可消除报错：

• 如果该函数仅在当前file.c内部使用
  • 修正函数定义的写法，和前置声明的存储类保持一致，在定义localFunc时补上static修饰符，避免链接属性不匹配的问题，正确写法示例：

    // definition of static function
    static void localFunc(uint32_t const input)
    {
       // do something
    }
    

  • 在需要该函数逻辑的位置（比如extFunc内部）补充对localFunc的合法调用，让编译器感知到函数的引用关系；
  • 如果当前开发阶段暂时还没写完调用逻辑、需要临时保留函数代码，可以在函数定义处加上ARM编译器支持的未使用标记__attribute__((unused))，主动告知编译器该函数暂时无引用，无需触发告警，写法示例：

    // 临时保留未使用静态函数的写法
    __attribute__((unused)) static void localFunc(uint32_t const input)
    {
       // do something
    }
    

• 如果该函数完全冗余、无实际业务作用
  • 直接删除localFunc的前置声明和完整函数定义，从根源上移除未引用的静态函数，即可消除检测报错。
• 如果该函数需要被其他源文件引用
  • 移除前置声明中给localFunc加的static修饰符，将函数改为全局外部链接属性，同时在file.h中补充该函数的extern声明，让其他源文件可以正常引用该函数，编译器就不会将其判定为文件内部未使用的函数。

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