面向Arduino等多平台的C单头文件多实现可读方案咨询

我正在开发一款面向Arduino项目的低成本传感器开源C驱动，需要兼容树莓派、Windows等Arduino生态外的多平台。项目采用platform.h统一头文件，搭配platform_arduino.c、platform_rpi.c、platform_windows.c等对应不同平台的实现文件结构。之前看过Stack Overflow上的跨平台C++单头多实现方案，但那套方案不适用于纯C项目。

我曾尝试在每个实现文件顶部添加平台条件编译指令，示例代码如下：

#if SOME_REQUIREMENT
#include  "platform.h"

int8_t  t_open(void)
{
    // 平台相关实现代码
}

#endif //SOME_REQUIREMENT

这种方案有两个棘手问题：

• 损害代码可读性：比如VS Code会将不符合当前编译条件的代码灰化，全局禁用该高亮规则又会影响项目其他部分的代码提示
• 调试条件冲突难度高：排查不同平台编译条件的冲突问题时很麻烦

由于项目核心是支持Arduino，很难通过Makefile技巧解决这些问题，现在想找一种能保持代码可读性的跨平台代码组织替代方案，如果必须用Makefile相关技巧也可以接受。

简化的头文件与实现示例 #

platform.h #

#ifndef __PLATFORM__
#define  __PLATFORM__

int8_t  t_open(void);

#endif //__PLATFORM__

platform_arduino.c #

#include  "platform.h"

int8_t  t_open(void)
{
    // Arduino平台下的实现代码
}

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