C语言从句柄到对象 (二) —— 极致的封装：不透明指针与 SDK 级设计

前言： 上一期我们定义了 Motor_t 结构体，并用指针 Motor_t* 作为句柄。 这种写法在团队内部使用没问题，但如果你是给别人写 库 (Library) 或 SDK，这种写法就是“不及格”的。

为什么？因为你把“内裤”都露给别人看了。

---

一、 “裸奔”的代价：为什么我们需要黑盒子？

让我们回顾一下上一期的代码。我们在头文件 motor.h 里是这样定义的：

// motor.h (上一期的写法，暂且称为 V1.0)
typedef struct {
    uint8_t current_speed;  // 内部状态
    uint8_t is_running;     // 内部标志位
    GPIO_TypeDef *port;     // 硬件配置
} Motor_t;

void Motor_SetSpeed(Motor_t *h, uint8_t speed);

这种写法最大的问题在于：使用者（User）能看到结构体的所有细节。

假设你发布了这个库。你的同事（或者未来的你自己）在写 main.c 时，为了图省事，可能会写出这种代码：

// main.c
int main() {