C 语言工业级通用组件手写 14:单向链表
目录前言一、单向链表核心本质与应用场景1. 什么是单向链表2. 解决的核心痛点3. 典型工业落地场景二、核心实现原理1. 带头结点设计2. 单向遍历机制3. 静态节点优先三、工业级设计规范1. 封装设计2. 接口设计3. 鲁棒约束4. 线程安全四、完整可复用源码1.slist.h2.slist.c五、实战演示六、进阶优化方向七、面试考点与易错坑点1.面试问答2.常见坑总结前言嵌入式很多资源紧张的 8 位单片机RAM 极小不需要反向遍历场景双向链表prev指针会额外占用内存。单向链表结构最简、内存开销最小适合简易节点管理。很多新手分不清单向链表与双向链表适用场景盲目全部使用双向链表本篇实现极简工业级单向链表支持静态节点、无动态内存强制依赖接口精简适合多路设备、简易任务列表、日志节点等轻量级管理场景。一、单向链表核心本质与应用场景1. 什么是单向链表单向链表每个节点仅包含后继 next 指针只能够从头节点向尾部单向遍历不存在前驱指针内存占用相比双向链表节省一半指针空间。特性节点无需连续内存支持动态增删不支持反向遍历查找指定节点删除时需要从头遍历。2. 解决的核心痛点解决小型单片机内存资源紧张问题省去 prev 指针减少 RAM 占用。解决数组长度固定、扩容难动态挂载节点不受预设数组大小限制。解决简易节点管理重复造轮子多路 IO、简易任务、临时日志统一管理。规避频繁 malloc 碎片支持静态定义节点全程使用静态内存。3. 典型工业落地场景简易多路传感器节点登记管理。临时日志、告警信息临时挂载链表缓存。简易任务列表顺序轮询执行。串口会话简易登记不需要反向查找场景。参数条目简易遍历管理。二、核心实现原理1. 带头结点设计采用独立头节点头结点不存储业务数据统一空链表、首尾节点边界处理逻辑消除大量 if 分支嵌入式标准写法。2. 单向遍历机制只能由 head 依次顺着 next 向后访问节点删除目标节点时需要保存前驱节点指针。3. 静态节点优先组件不强制动态堆分配节点定义为全局 / 局部静态变量杜绝内存碎片、分配失败风险。三、工业级设计规范1. 封装设计基础链表节点结构体通用业务结构体内嵌链表节点不需要内存拷贝。2. 接口设计接口功能说明slist_init初始化链表头结点slist_add_head头部插入节点slist_add_tail尾部插入节点slist_remove移除指定节点slist_is_empty判断链表为空slist_foreach单向遍历所有节点3. 鲁棒约束空指针全部校验禁止同一节点重复挂载节点移除后置空 next 指针避免野指针纯 C 无第三方依赖裸机通用。4. 线程安全单线程天然安全多线程并发操作链表外部增加关中断或者互斥锁保护。四、完整可复用源码1.slist.h#ifndef SLIST_H #define SLIST_H #include stddef.h #include stdbool.h #ifdef __cplusplus extern C { #endif //单向链表基础节点 typedef struct slist_node { struct slist_node *next; } slist_node_t; /** * brief 初始化单向链表头 */ void slist_init(slist_node_t *head); /** * brief 头部插入节点 */ void slist_add_head(slist_node_t *head, slist_node_t *node); /** * brief 尾部插入节点 */ void slist_add_tail(slist_node_t *head, slist_node_t *node); /** * brief 删除指定节点 */ bool slist_remove(slist_node_t *head, slist_node_t *node); /** * brief 判断链表是否为空 */ bool slist_is_empty(slist_node_t *head); // 通过链表节点获取宿主结构体 #define slist_container_of(ptr, type, member) \ ((type *)((char *)(ptr) - offsetof(type, member))) //单向遍历宏 #define slist_foreach(pos, head) \ for (pos (head)-next; pos ! NULL; pos pos-next) #ifdef __cplusplus } #endif #endif2.slist.c#include slist.h void slist_init(slist_node_t *head) { if(head NULL) return; head-next NULL; } void slist_add_head(slist_node_t *head, slist_node_t *node) { if(head NULL || node NULL) return; node-next head-next; head-next node; } void slist_add_tail(slist_node_t *head, slist_node_t *node) { if(head NULL || node NULL) return; slist_node_t *p head; while(p-next ! NULL) { p p-next; } node-next NULL; p-next node; } bool slist_remove(slist_node_t *head, slist_node_t *node) { if(head NULL || node NULL || slist_is_empty(head)) return false; slist_node_t *prev head; slist_node_t *curr head-next; while(curr ! NULL) { if(curr node) { prev-next curr-next; node-next NULL; return true; } prev curr; curr curr-next; } return false; } bool slist_is_empty(slist_node_t *head) { if(head NULL) return true; return head-next NULL; }五、实战演示#include stdio.h #include slist.h //业务节点示例 typedef struct { uint8_t dev_id; slist_node_t node; } dev_item_t; dev_item_t dev1, dev2, dev3; int main(void) { slist_node_t slist_head; slist_init(slist_head); dev1.dev_id 1; dev2.dev_id 2; dev3.dev_id 3; slist_add_tail(slist_head, dev1.node); slist_add_tail(slist_head, dev2.node); slist_add_tail(slist_head, dev3.node); slist_node_t *pos; slist_foreach(pos, slist_head) { dev_item_t *item slist_container_of(pos, dev_item_t, node); printf(设备ID%d\n, item-dev_id); } slist_remove(slist_head, dev2.node); printf(删除设备2完成\n); return 0; }六、进阶优化方向增加链表节点计数不需要遍历即可获取节点总数缓存尾指针规避尾插每次从头遍历提升尾部插入效率支持按条件查找节点封装通用接口七、面试考点与易错坑点1.面试问答Q1单向链表与双向链表怎么选型答只需要正向遍历、追求最小内存占用、无频繁随机删除场景 → 单向链表需要快速删除、双向遍历、频繁随机移除节点 → 双向链表。Q2单向链表删除节点为什么需要前驱指针答节点本身无法访问上一级节点必须遍历保存前驱修改前驱 next 指针。Q3单向链表尾部插入效率短板如何优化答可以额外保存尾指针不需要每次遍历到链表末尾。2.常见坑节点移除不置空 next 指针引发野指针重复添加同一个节点形成环形链表死循环遍历时直接删除当前遍历节点导致遍历断链崩溃。总结单向链表是资源受限单片机首选动态容器结构极简、内存开销最低。在不需要反向遍历的场景下相比双向链表拥有天然 RAM 优势。适合简易设备管理、任务列表等轻量级业务是嵌入式底层基础数据结构。创作不易如果对你有帮助欢迎点赞、收藏、转发。