C 头文件中的 static inline：寄存器访问函数
一句话回答
在头文件里定义很短的寄存器访问/位操作函数时，用 static inline 修饰：inline 建议编译器把它就地展开、省掉函数调用开销，static 让它只在当前编译单元可见、不产生外部符号，于是这个头文件被多个 .c 同时包含时，每个编译单元各持一份私有副本，不会因为「同一函数被重复定义」而链接报错。
一、典型用法
c
// regs_helper.h
#ifndef REGS_HELPER_H
#define REGS_HELPER_H
#include <stdint.h>
#define REG_CTRL (*(volatile uint32_t *)0x40020000U)
static inline void ctrl_set_bit(uint32_t b) {
REG_CTRL |= (1U << b);
}
static inline int ctrl_get_bit(uint32_t b) {
return (REG_CTRL >> b) & 1U;
}
#endif任意多个 .c 文件 #include "regs_helper.h" 都能直接调用，且不会链接冲突。
二、两个关键字各管什么
inline：这是一个「建议」而非强制——编译器倾向把函数体插到调用处，短函数可省去进出栈和跳转开销，对频繁的寄存器操作很有价值。static：把函数链接属性限制在本编译单元（当前.c及它包含的头）内部，不导出全局符号。各编译单元的副本互不可见，因此不违反 C 的「外部标识符只能有一个定义」规则。
如果只写普通非 static 函数定义在头文件，多个 .c 包含后会在链接阶段报 multiple definition 重复定义错误。
三、和宏的取舍
同样的功能也能用宏实现，但 static inline 有明显优势：
- 有类型检查，参数只求值一次（宏可能因多次替换被重复求值出副作用）；
- 可以有多条语句、局部变量、返回值，可读性和可调试性更好；
- 调试器里能下断（未被强制内联时）。
因此现代 C 头文件里，短小工具函数优先用 static inline，宏留给条件编译和常量拼接。
常见坑
- 头文件里定义非 static 函数：多文件包含导致 multiple definition。
- 只写 inline 不写 static：仍可能产生外部链接与重复定义问题。
- 把大函数塞进 static inline 头文件：每个编译单元一份，增大代码体积，应放
.c里。 - 以为 inline 一定被内联：编译器可拒绝（如取了函数地址、函数太长）。
- 在里面放需要单一实例的静态状态：各副本的
static变量不共享，容易误判。 - 函数依赖未定义类型/寄存器宏：头文件要把依赖一起包含进来。
总结
头文件里的短小寄存器访问函数用 static inline：inline 建议就地展开省调用开销，static 限定为编译单元内部、不导出符号，从而被多个 .c 包含也不重复定义；相比宏它有类型检查、参数不求值多次、更易调试，但大函数不要放进来，且 inline 只是建议不一定生效。