我最早从 C 语言跳到 AVR 汇编的时候心里想的其实很朴素无非就是把 if/else 翻译成跳转把变量塞进寄存器再小心点别把栈搞坏。真正动手写了两个启动文件之后才发现最折磨人的根本不是分支和算术而是满屏重复——十几个寄存器要清零三个端口要配输入输出好几处都是同一小段代码换个寄存器再来一遍。后来我把 AVAVR 汇编里的宏macros用熟了这种重复感才彻底降下来。宏这东西说穿了就是汇编器替你做的“文本复制粘贴”你定义一段模板给它起个名字每次写下这个名字汇编器就把模板展开成一段真实的指令。它没有 CALL/RET不占栈运行成本和直接手写一模一样的代码没有任何区别。这篇文章我打算把宏从语法、参数、条件展开、常见坑到宏库设计完整讲一遍适合刚开始学 AVR 汇编、或者已经写了几百行但被重复代码整烦了的开发者。凡是能在编译期解决的问题就不要拖到运行期去纠结。1. 没有宏的 AVR 汇编到底有多痛苦1.1 寄存器清零这件小事居然要写几十行AVR 这种 RISC 架构看起来指令很简洁但简洁的另一面就是啰嗦。最典型的就是启动代码里的寄存器清零。AVR 有 32 个通用寄存器 r0 到 r31很多 MCU 的复位状态并不保证它们都是 0于是启动阶段就要手动清一遍。没有宏的时候代码长这样clr r0 clr r1 clr r2 clr r3 ... clr r3132 行 CLR一条不多一条不少。更难受的是如果某次启动我其实想保留 r15 的值得手动删掉那一行再认真检查上下文有没有写错。这种代码毫无技术含量却特别容易在复制粘贴时翻车。比如把clr r16误写成clr r17编辑器不会报错程序也能跑只是某个寄存器莫名其妙被清了鬼知道要排查多久。这还只是寄存器清零。再往后写端口初始化、SP 设置、定时器配置全是这种重复的“寄存器写值”模式。C 语言里有函数、有数组、有 for 循环汇编里你只有指令本身。如果没有宏就只能靠复制粘贴而复制粘贴就是 bug 的温床。1.2 宏是“编译期的复制粘贴”子程序是“运行期的跳转”很多人刚接触宏的时候最大的困惑是这玩意儿和子程序subroutine到底有啥区别不都是把一段代码复用吗区别其实特别本质宏在汇编阶段就地展开子程序在运行阶段来回跳转。宏调用时汇编器不会生成 CALL 指令而是在调用点把宏体原样复制一份。它没有调用开销不需要压栈也没有 RET 指令。代价是每次调用宏都会在 Flash 里多产生一份代码。子程序反过来代码只在 Flash 里存在一份运行时通过 CALL/RET 跳来跳去但每次调用都有至少 4 个周期的 CALL 开销还要处理参数传递和寄存器现场保护。我用一个表把两者的差别理清楚写汇编前先想一遍这个表能少走很多弯路维度宏 (Macro)子程序 (Subroutine)代码存放每次调用处展开一份副本Flash 中只存一份调用开销零编译期完成CALL RET至少 4 周期参数传递编译期文本替换灵活需用寄存器或栈约定局部标签需要额外处理唯一性天然有独立作用域上下文保护宏体自己负责 push/pop调用方或被调方按约定保护调试难度展开后目标文件变大行号错位调试器可单步进入适用场景短小、高频、性能敏感的操作较长、低频、逻辑独立的操作生活化类比宏是复印机你把模板复印多少份都行每份放在调用点子程序是去图书馆借一本书书只有一本谁看都得走过去翻。复印适合高频次小段内容借书适合大部头慢慢读。1.3 什么时候别迷信宏宏不是万能药滥用一样会吃亏。我自己的经验法则是一段代码如果少于 5 条指令并且你在项目里要重复 3 次以上毫不犹豫写宏如果一段代码超过 20 条指令哪怕重复 5 次我一般也会先想想能不能用子程序解决。原因很简单宏零开销的优势在短序列上体现得最明显一旦宏体变长Flash 膨胀的速度非常吓人。还有一个场景要特别小心复位向量附近。MCU 刚上电时栈指针SP可能还没初始化这时候如果用子程序CALL 指令会把返回地址压到一个未知的栈位置程序直接跑飞。所以启动早期那段代码用宏比用子程序安全得多。这也是为什么很多 AVR 汇编启动代码即使没有宏也会写成一大段线性指令而不是调用子程序。2. 宏的语法就像给汇编塞了一个“文本生成器”.macro 与参数的打开方式2.1 三段式定义、调用、展开宏的基本结构特别简单.macro开头.endm结尾中间是宏体。我以 GNU 汇编器avr-as也就是 avr-gcc 链里的汇编器的语法为例这也是我自己平时用得最多的环境。.macro CLR3 reg1, reg2, reg3 clr \reg1 clr \reg2 clr \reg3 .endm调用时直接写宏名加参数CLR3 r0, r1, r16汇编器会在展开后生成clr r0 clr r1 clr r16注意 GNU as 的宏参数引用是反斜杠加名字比如\reg1如果你用的是 Microchip 官方 AVR Assembleravrasm2参数引用要改成0、1这样的位置编号。这两种写法不通用但背后逻辑完全一样。写的时候确定好你用的是哪套工具链别混着写。我整理了个小对照表方便两边切换功能GNU as (avr-as)Microchip avrasm2宏定义.macro name args.macro name args宏结束.endm.endm位置参数\1或\名字0、1退出宏.exitm.exitm本地唯一标签\生成唯一编号无自动机制需手动唯一2.2 参数本质是“文本替换”不只是寄存器我第一次用宏的时候以为参数只能传寄存器后来才发现大错特错。宏参数在汇编阶段就是一段文本宏体里出现\参数
