C语言书写规范

发表于 2026-9-7 22:38

喂狗代码必须放在主循环的显眼位置，严禁放在定时器中断里。

发表于 2026-9-8 11:48

采用类型前缀 + 作用域前缀 + 语义名的分层体系

发表于 2026-9-8 13:30

在单片机资源受限的环境下，良好的书写规范不仅提升可维护性，更能有效避免因类型误用、ISR 阻塞、内存越界等问题导致的现场故障。

发表于 2026-9-9 08:11

避免使用非标准C扩展，确保代码在不同编译器下可编译；注意数据类型定义以保证跨平台一致性。

发表于 2026-9-9 11:23

宏表达式全部加括号，优先级错误是高频 BUG。

发表于 2026-9-9 19:37

关键算法注释特别是 PID 运算、滤波算法，需附上公式出处或设计思路。

发表于 2026-9-10 09:02

统一缩进，控制语句后添加空格，花括号独占一行或紧跟语句，长表达式适当换行对齐。

发表于 2026-9-10 10:15

ISR 内部仅做标志置位和数据搬运，耗时操作移至主循环处理

发表于 2026-9-10 18:29

单片机资源有限，需注意内存分配、中断服务程序简洁高效，避免在ISR中进行复杂计算或阻塞操作。

发表于 2026-9-10 19:37

复杂逻辑、算法、硬件寄存器操作必须添加注释。

发表于 2026-9-10 21:33

注释应与代码同步更新，删除无用代码时一并删除相关注释。

发表于 2026-9-11 12:02

如果变量名是 temp，仅仅看名字无法知道是温度值还是循环计数器。加上单位或前缀会清晰得多。

发表于 2026-9-11 20:55

分支语句和循环体建议添加注释说明意图。

发表于 2026-9-12 17:38

将功能相近的代码封装为函数或模块，遵循单一职责原则，减少重复代码；全局变量尽量少用，优先使用局部变量和函数参数传递数据。

发表于 2026-9-12 18:25

每个函数只完成一个明确的功能，长度不超过 50 行。复杂逻辑必须拆分为子函数。

发表于 2026-9-12 22:22

关键功能模块、复杂算法、接口函数需添加注释，说明功能、参数、返回值；单行注释解释代码目的，避免冗余注释。

发表于 2026-9-13 09:52

单片机 C 语言规范的终极目标，是在 “代码执行效率” 与 “人类可读性” 之间找到平衡。

发表于 2026-9-13 12:45

说明入参范围、返回值含义、是否可重入。

发表于 2026-9-13 13:33

禁止使用软件循环延时，避免温度漂移导致时序偏差。

[经验分享] C语言书写规范