C语言中用法一致时，函数需声明为宏吗？含通用列表规范疑问

要不要为一致性把函数改成宏？ #

不用硬凑表面一致性，优先根据实现需求和特性差异来选择：

• list_init(type)这类宏是因为需要处理类型生成特定代码，必须用宏实现；但list_add(void*)用函数完全能满足需求时，函数是更优选择：
  • 函数有明确的类型检查（哪怕是void*，参数类型也有约束），调试更方便（可直接断点），不会因宏展开导致代码膨胀或参数副作用问题；
  • 宏的编译期无调用开销优势，只有在list_add的性能瓶颈确实在函数调用时才有意义，否则函数的可维护性价值远大于这点性能收益。

强行把list_add改成宏，只会徒增代码风险，完全没必要为了一致性牺牲正确性和可维护性。

命名规范要不要统一？ #

必须统一。只要是同一套通用列表API的操作，不管底层是宏还是函数，命名风格要完全一致：

• 使用者只会关注这是列表操作的接口，不会在意底层实现是宏还是函数；如果命名风格分裂（比如宏用全大写LIST_INIT，函数用小写list_add），会增加认知负担，容易误用；
• 建议统一用同一风格（比如全小写加下划线list_xxx），让整套API看起来是一个整体，降低学习和使用成本。

示例代码 #

// 类型相关的初始化宏
#define list_init(type) \
    ((type##_list_t){.data = NULL, .size = 0, .capacity = 0})

// 通用添加函数
void list_add(void* list, void* element);

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