14. 结构体与typedef：typedef简化结构体声明、常见命名规范

说实话，刚学C语言那会儿，我每次写结构体都要敲一遍 struct 关键字，心里总觉得别扭。明明是个类型，为啥每次用都得带个帽子？后来接触了 typedef，才觉得世界清净了。这一节，我就跟你聊聊怎么用 typedef 给结构体“改名”，以及命名上的一些门道。

为什么需要 typedef？

你想想看，如果没有 typedef，定义一个结构体变量得这么写：

struct Student {
    char name[32];
    int age;
    float score;
};

// 每次使用都要带 struct
struct Student stu1;
struct Student *pStu;

每次都要敲 struct，代码一长，看着就累。而且 struct Student 本身不是一个“原子”的类型名，它是个组合词。用 typedef 给它起个“别名”，就能像用 int、float 一样自然。

typedef 简化结构体声明

最常见的做法，是在定义结构体的同时，直接用 typedef 给它起别名：

typedef struct {
    char name[32];
    int age;
    float score;
} Student;

// 现在可以直接用 Student
Student stu1;
Student *pStu;

你看，struct 关键字消失了。代码干净了很多。我个人习惯把别名和结构体标签名保持一致，比如：

typedef struct Student {
    char name[32];
    int age;
    float score;
} Student;

这样写的好处是，既保留了 struct Student 这个完整类型名（某些特殊场景可能需要），又有了简洁的 Student 别名。嗯，这里要注意：C语言中，struct Student 和 Student 是等价的，可以混用。

指针类型的 typedef

结构体指针也经常用 typedef 简化。我在项目中遇到过一种写法，把指针类型也封装起来：

typedef struct Node {
    int data;
    struct Node *next;
} Node, *NodePtr;

这里 NodePtr 就是 struct Node * 的别名。不过我个人不太推荐这种写法——把指针藏起来，有时候反而让代码意图不清晰。你看到 NodePtr p，还得想一下它是不是指针。不如直接写 Node *p 来得直白。

常见命名规范

命名这件事，不同公司、不同项目可能有自己的规矩。但有几个通用的原则，我这些年一直遵守：

• 大驼峰命名：类型名用大驼峰，比如 Student、LinkedList、ConfigManager。变量名用小驼峰，比如 studentAge、configPtr。
• 加后缀 _t：很多嵌入式代码喜欢在类型名后面加 _t，比如 student_t、gpio_config_t。这来自 POSIX 标准，一眼就能看出这是个类型。
• 避免单字母：别用 typedef struct { ... } S; 这种。代码是给人读的，不是给编译器看的。
• 与模块名关联：比如你写一个 I2C 驱动，结构体可以叫 i2c_device_t，函数叫 i2c_read()。这样命名空间清晰，不会跟别的模块冲突。

风格	示例	适用场景
大驼峰	StudentInfo	通用、跨平台项目
小写+下划线+_t	student_info_t	嵌入式、Linux 内核风格
模块前缀+大驼峰	I2C_Device	大型项目、模块化设计

避坑指南：typedef 与结构体自引用

我曾经在写链表的时候踩过一个坑。看这段代码：

typedef struct {
    int data;
    Node *next;  // 编译错误！
} Node;

为什么会报错？因为 typedef 的别名 Node 在结构体定义结束之后才生效。在结构体内部，编译器还不认识 Node。正确的写法是：

typedef struct Node {
    int data;
    struct Node *next;  // 必须用 struct Node
} Node;

或者用 Node *next 也行，但前提是前面已经声明了 struct Node。嗯，这里要记住：结构体自引用时，必须使用完整的 struct 标签名。

知识体系图

下面这张图帮你理清 typedef 与结构体的关系：

实际项目中的用法

我在做嵌入式项目时，经常这样用 typedef：

// 硬件寄存器映射
typedef struct {
    volatile uint32_t CR;    // 控制寄存器
    volatile uint32_t SR;    // 状态寄存器
    volatile uint32_t DR;    // 数据寄存器
} UART_Reg_t;

// 配置参数
typedef struct {
    uint32_t baudrate;
    uint8_t  data_bits;
    uint8_t  stop_bits;
    uint8_t  parity;
} UART_Config_t;

你看，UART_Reg_t 和 UART_Config_t 一眼就能看出是类型，而且跟模块名 UART 关联。代码的可读性和可维护性都提高了。

好了，关于 typedef 和结构体的搭配，就聊这么多。记住一句话：typedef 是为了让代码更清晰，不是为了炫技。用得恰当，代码如诗；用得过度，反而让人困惑。

---

公众号:蓝海资料掘金营，微信deep3321