printf 格式不匹配导致 Debug 数据错位问题

问题描述

在 ../sys/measure.c 第 260 行通过 dbg_info 打印调试信息：

dbg_info("nv=%d,p=%d,t=%d", temp_data.sensor_data[1].normal_volt, pos, tail);

现象

核心矛盾：变量在内存中的值都是对的，但 printf 打印出来 pos 却是 0。

根因分析

2.1 变量类型

typedef struct {    long long normal_volt;  // 8 字节（64位）    ...} sensor_data_t;int pos;    // 4 字节（32位）int tail;   // 4 字节（32位）

2.2 Debug 观察窗 vs printf 的读取机制

Debug 观察窗完全绕过了 printf 的变参机制，所以三个值都正确——这恰好证明了变量本身的值没有问题。

2.3 printf 参数错位过程

printf("nv=%d,p=%d,t=%d", normal_volt, pos, tail)

调用时，三个参数依次压入 varargs 栈，printf 按 %d（4 字节）逐个消费：

栈布局 (低地址在上，printf 从低地址向高地址依次取 %d)：┌──────────────────────┐│ normal_volt 低4字节   │ ← %d#1 → 打印 "nv" (正确)├──────────────────────┤│ normal_volt 高4字节   │ ← %d#2 → 打印 "pos" (恒为 0)├──────────────────────┤│ pos (4字节)          │ ← %d#3 → 打印 "tail" (实际是 pos 的值)├──────────────────────┤│ tail (4字节)          │   未读取└──────────────────────┘

2.4 为什么 nv 和 tail "看起来"正确

nv 正确：normal_volt 数值较小（低 32 位就够表示），高 32 位为 0，低 32 位被 %d#1 读取后自然正确;tail 正确：%d#3 实际读到的是 pos 的真实值，在测试场景下 pos 和 tail 的数值恰好相近或相等，造成"tail 也对"的假象;

实际上三个变量全部错位，只是两个碰巧对上了。

3. 解决方案

// 错误：%d 只能读 4 字节，long long 是 8 字节

dbg_info("nv=%d,p=%d,t=%d", temp_data.sensor_data[1].normal_volt, pos, tail);

// 正确：%lld 读 8 字节，后续参数自动对齐

dbg_info("nv=%lld,p=%d,t=%d", temp_data.sensor_data[1].normal_volt, pos, tail);

4. 经验总结

5. 常见类型格式符速查