Ceedling中CMock无法为静态内联函数生成Mock的问题求助

问题背景 #

使用Ceedling v0.31.1（搭配Unity v2.5.4、CMock v2.5.4）进行嵌入式单元测试时，第三方驱动头文件中的**静态内联函数（static inline）**无法被CMock生成Mock。移除static inline修饰改为普通函数声明后，CMock可正常生成Mock函数；但保留原static inline定义时，会出现编译警告implicit declaration of function 'LL_GPIO_ResetOutputPin_Ignore'及链接错误undefined reference to 'LL_GPIO_ResetOutputPin_Ignore'。

本质原因：static inline函数在编译阶段会被直接展开到调用处，不会生成全局符号，而CMock依赖链接时替换函数符号的机制生成Mock，因此无法拦截这类编译期展开的函数。

解决方案 #

方案1：头文件重定向（推荐，适合大量static inline函数） #

通过Ceedling的头文件重定向机制，用自定义头文件替换原驱动头文件，将static inline函数改为普通声明：

1. 在测试目录下创建替代头文件，比如test/support/stm32f4xx_ll_gpio.h，将原头文件中的static inline函数改为普通函数声明：

   void LL_GPIO_ResetOutputPin(GPIO_TypeDef *GPIOx, uint32_t PinMask);
   // 其他需要Mock的函数同理修改
   

2. 在project.yml中配置头文件搜索优先级，让测试编译时优先使用自定义头文件：

   :paths:
     :support:
       - test/support  # 让测试代码优先搜索此目录下的头文件
   :cmock:
     :header_redirection:
       - ['stm32f4xx_ll_gpio.h', 'test/support/stm32f4xx_ll_gpio.h']  # 重定向原头文件到自定义版本
   

方案2：宏替换（适合少量static inline函数） #

通过宏定义将原static inline函数的调用替换为CMock生成的Mock函数：

• 在project.yml的测试定义中添加全局宏：

  :defines:
    :test:
      - LL_GPIO_ResetOutputPin=LL_GPIO_ResetOutputPin_CMock
  

  编译测试代码时，所有对LL_GPIO_ResetOutputPin的调用都会被替换为CMock生成的Mock函数名，确保CMock能拦截并处理。

方案3：强制编译器不展开inline函数（兼容性有限） #

通过编译器选项关闭inline展开，让static inline函数生成全局符号，配合CMock的静态函数处理：

1. 在project.yml中配置CMock处理静态函数：

   :cmock:
     :treat_static: true
     :includes:
       - stm32f4xx_ll_gpio.h
   

2. 添加编译器选项禁用inline展开：

   :compiler:
     :flags:
       :test:
         - -fno-inline  # GCC/Clang选项，强制不展开inline函数
         - -O0          # 关闭优化，避免编译器自动展开
   

   注意：此方案依赖编译器支持，部分嵌入式编译器可能不兼容，且会影响测试代码的编译效率。

方案对比 #

• 方案1：隔离测试环境，不修改原驱动代码，适合大量函数的场景，维护成本低。
• 方案2：灵活快捷，适合少量需要Mock的函数，但需逐个配置宏。
• 方案3：无需修改头文件，但依赖编译器选项，兼容性较差，可能引入编译性能损耗。

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