C语言函数返回值用#define还是独立enum更利于可读性和文档维护？

第二种使用自定义枚举类型作为返回值的方案，更有利于提升代码可读性和后续文档维护效率，核心原因如下：

• 类型安全性更高
  枚举是独立的自定义类型，编译器会对返回值、变量赋值做合法性校验：如果函数返回了不在RET_VAL枚举定义内的取值，或者你把RET_VAL类型的变量随意赋值给不相关的整型变量、传入错误参数类型，编译器都可以抛出警告提示。而第一种int+宏定义的方案没有类型约束，就算函数随便返回个1234这种不在定义内的数值，编译器也不会报错，排查问题成本极高。
• 可读性更强
  函数签名明确标注返回值类型是RET_VAL，其他开发者看函数声明的时候，一眼就能知道这个函数的返回值只能是预定义的枚举取值，不用额外去翻全局宏定义找哪些int值是该函数的合法返回值。
• 后续维护成本更低
  后续如果要新增返回值类型（比如参数错误、内存不足等细分错误码），只要往RET_VAL枚举里追加取值即可，所有用该枚举作为返回值的函数都可以复用这套定义，不用零散新增大量宏，也能避免宏重名、冲突的问题。同时主流IDE的自动补全功能，会根据枚举类型自动提示可选的返回值，开发效率也更高。

如果你的项目需要兼容C89等极老旧的C标准，或者返回值需要和外部非C接口做对齐，可以选择第一种宏定义的方案，除此之外的常规现代C开发场景，更推荐使用枚举方案。

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