4. 基础规则解读（二）：标识符、命名冲突与基本类型
各位好，欢迎来到第四章。今天咱们聊的这几个规则，说白了就是「起名字」和「选类型」的学问。你可能觉得这有什么好讲的？我在项目里见过太多因为名字没起好、类型选错导致的线上事故了。嗯，咱们一个一个来看。
4.1 规则4.1-4.2：标识符长度与作用域
规则4.1要求：标识符（变量名、函数名）的有效字符数不能超过31个。规则4.2则说：外部链接的标识符，有效字符数不能超过6个。
你可能会问：现在编译器都支持长名字了，为什么还要限制？
原因其实很现实。我记得有一次做跨平台移植，代码在ARM上编译通过，换到某个老牌DSP编译器上就报链接错误。查了半天，发现是函数名超过6个字符，链接器只认前6个，结果两个不同的函数被当成同一个了。那叫一个惨。
核心要点：
- 内部标识符（static函数、局部变量）：最多31个有效字符
- 外部标识符（全局变量、非static函数）：最多6个有效字符
- 建议：外部符号尽量短且有规律，比如
adc_read、pwm_set
我的习惯：所有外部接口函数统一用「模块名_动作」的格式，比如 uart_send、timer_start，长度控制在6个字符以内。内部函数随便写，但别超过31个字符。
4.2 规则5.1-5.9：标识符命名冲突
这一组规则，核心就一句话：别让名字撞车。但实际撞车的方式，比你想象的要多。
规则5.1-5.3讲的是：标识符不能和关键字、标准库宏、标准库函数重名。这个好理解，但容易犯。我曾经见过有人定义了一个 int32_t 的变量叫 min，结果跟 <stdlib.h> 里的宏撞了，编译报错报得莫名其妙。
规则5.4-5.6更隐蔽：不同作用域下的同名变量。比如全局有个 count，函数里又定义了个局部 count。编译器不会报错，但维护的人看到代码，鬼知道哪个 count 是哪个。
我曾经踩过的坑：一个同事在中断服务函数里定义了一个局部变量 temp，跟全局的 temp 重名。结果中断里改了局部变量，全局变量纹丝不动，bug查了三天。从那以后，我要求团队所有全局变量加 g_ 前缀，局部变量不加，一眼就能区分。
规则5.7-5.9讲的是：宏定义和枚举常量的命名冲突。宏定义没有作用域概念，一旦定义，整个文件都可见。枚举常量也是全局可见的。所以，宏和枚举常量最好用全大写加前缀，比如 ADC_CHANNEL_0、GPIO_PIN_5。
下面这张图，帮你理清命名冲突的几种场景：
4.3 规则6.1-6.3：基本类型与位域
规则6.1说：不要直接使用 char、int、long 等基本类型，要用 stdint.h 里定义的类型。比如 uint8_t、int32_t、uint64_t。
为什么？因为 int 在8位单片机上是16位，在32位处理器上是32位，在64位系统上又是32位（Windows）或64位（Linux）。你写个 int count，换个平台长度就变了，代码的移植性直接归零。
推荐的类型使用对照表：
| 场景 | 不推荐 | 推荐 |
|---|---|---|
| 8位无符号整数 | unsigned char |
uint8_t |
| 16位有符号整数 | short |
int16_t |
| 32位无符号整数 | unsigned long |
uint32_t |
| 布尔值 | int flag |
bool（来自 <stdbool.h>） |
规则6.2讲的是：位域（bit-field）的类型必须使用 unsigned int 或 signed int。不能用 char、short 之类的类型做位域。
规则6.3更严格：位域的长度不能为0。长度为0的位域是用来做对齐的，但MISRA C禁止这种用法，因为不同编译器对它的处理方式不一样。
我曾经遇到的情况：一个硬件寄存器定义用了位域，类型写的是 unsigned char。在GCC上编译没问题，换到IAR上，位域的布局完全变了，读出来的寄存器值全是错的。后来全部改成 unsigned int，问题解决。记住：位域就用 unsigned int，别整花活。
下面是一个符合MISRA C规范的位域定义示例：
/* 符合MISRA C规则6.1-6.3的位域定义 */
#include <stdint.h>
#include <stdbool.h>
/* 正确：使用unsigned int作为位域类型 */
typedef struct {
unsigned int enable : 1; /* 规则6.2：类型正确 */
unsigned int mode : 2;
unsigned int trigger : 1;
unsigned int reserved : 4; /* 规则6.3：长度不为0 */
} ControlReg_t;
/* 错误示例（仅供对比，不要这样写） */
typedef struct {
unsigned char enable : 1; /* 违反规则6.2 */
unsigned char mode : 2;
unsigned char : 0; /* 违反规则6.3 */
} BadReg_t;个人建议：如果位域超过32位，直接用 uint32_t 数组加位掩码操作，别用位域。位域在跨平台时太容易出幺蛾子了。
4.4 本章小结
咱们今天聊了三组规则，其实核心就两件事：
- 起名字：注意长度限制、避免冲突、加前缀区分作用域
- 选类型：用
stdint.h的定长类型、位域只用unsigned int
这些规则看起来琐碎，但每一条背后都有血淋淋的教训。你想想看，一个命名冲突导致的bug，可能比算法逻辑错误更难排查。所以，从项目一开始就按规范来，后面能省下大把调试时间。