如何将struct/enum定义在.c源文件，仅在.h头文件提供接口？

完全可以把结构体（struct）、枚举（enum）的具体定义放在.c源文件中，仅在.h头文件对外提供接口，以此实现内部结构的隐藏，这是C语言里模拟封装特性的经典做法，分别针对结构体和枚举有不同的实现方式：

一、结构体：用不透明指针（Opaque Pointer）实现隐藏 #

头文件只声明结构体类型，不暴露任何内部成员；具体的结构体定义和成员实现放在.c源文件里，对外只提供操作结构体的函数接口。

示例代码 #

头文件（my_struct.h）：

// 仅声明结构体类型，外部无法知晓内部成员
typedef struct MyStruct MyStruct;

// 对外提供的操作接口：创建、修改、读取、销毁
MyStruct* my_struct_create(int init_value);
void my_struct_set_value(MyStruct* s, int new_value);
int my_struct_get_value(MyStruct* s);
void my_struct_destroy(MyStruct* s);

源文件（my_struct.c）：

#include "my_struct.h"
#include <stdlib.h>

// 具体定义结构体内部成员，仅当前源文件可见
struct MyStruct {
    int core_value;
    // 可以添加更多私有成员，比如char buffer[64];
};

// 实现接口函数
MyStruct* my_struct_create(int init_value) {
    MyStruct* s = malloc(sizeof(MyStruct));
    if (s != NULL) {
        s->core_value = init_value;
    }
    return s;
}

void my_struct_set_value(MyStruct* s, int new_value) {
    if (s != NULL) {
        s->core_value = new_value;
    }
}

int my_struct_get_value(MyStruct* s) {
    return (s != NULL) ? s->core_value : -1;
}

void my_struct_destroy(MyStruct* s) {
    free(s);
}

外部代码只能通过这些接口函数操作MyStruct，完全无法直接访问或修改其内部成员，实现了结构隐藏。

二、枚举：隐藏具体枚举值，仅暴露类型 #

如果要隐藏枚举的具体取值，头文件只声明枚举类型，不定义枚举常量；具体的枚举值定义放在.c源文件中，对外通过函数接口交互，不直接暴露常量。

示例代码 #

头文件（my_enum.h）：

// 仅声明枚举类型，外部不知道具体取值
typedef enum MyEnum MyEnum;

// 对外接口：获取枚举值、验证枚举有效性
MyEnum my_enum_get_default();
int my_enum_is_valid(MyEnum val);

源文件（my_enum.c）：

#include "my_enum.h"

// 具体定义枚举值，仅当前源文件可见
enum MyEnum {
    PRIVATE_OPT_A,
    PRIVATE_OPT_B,
    PRIVATE_OPT_C
};

MyEnum my_enum_get_default() {
    return PRIVATE_OPT_A;
}

int my_enum_is_valid(MyEnum val) {
    return (val >= PRIVATE_OPT_A && val <= PRIVATE_OPT_C);
}

外部代码只能拿到MyEnum类型，无法直接使用PRIVATE_OPT_A这类常量，只能通过接口函数获取或验证枚举值，隐藏了内部定义细节。

注意事项 #

• 结构体的不透明指针无法直接使用sizeof，必须通过接口函数处理内存分配/释放；
• 枚举隐藏后，外部不能直接比较枚举值与具体常量，需依赖提供的验证或转换接口；
• 这种方式适合需要保护内部实现、避免外部直接依赖结构细节的场景，能提升代码的可维护性——修改内部结构时，只要接口不变，外部代码无需改动。

内容的提问来源于stack exchange，提问作者Harjeev.Sharma