一、案例描述
/************************************************************************//*打印中文，要先用sprintf将中文打印进字符串在嵌入式/RTOS 开发中，用 sprintf通常是为了组合多条信息 + 方便调试/日志系统。统一在一个变量里面方便管理*/sprintf(msg,"按键：%d 次，数据：%d 次",(int)buttonCount,(int)dataCount);printf("%s",msg);/*直接打印中文，不推荐，不方便后续的调试和日志系统生成*/printf("按键：%d 次，数据：%d 次",(int)buttonCount,(int)dataCount);/*最直接，打印英文，这个不容易产生因编码问题而导致的报错但是也不推荐直接打印*/printf("button:%d , data:%d",(int)buttonCount,(int)dataCount);
/***************************************************************************
二、问题分析
在嵌入式开发里，很少直接写一串很长的 printf("xxx %d yyy %d ...", a, b, c)，而是常用 sprintf 先把内容拼成字符串，再统一输出，主要有这几类原因：
1、方便做“日志/报文”的统一封装
嵌入式很多场景要把信息按固定格式打包，比如：
• 日志：[时间] [等级] 模块名：事件描述，参数=xx
• 通信协议：AT+CMD=param1,param2\r\n
• 存储记录：2025-02-24,12:00:00,KEY1,5
用 sprintf 可以把各种变量拼成一条完整报文，再交给底层输出函数（串口、网络、Flash）：
char log_buf[128];
sprintf(log_buf, "[%s] KEY按下: %d次, 数据: %d条", get_time_str(), key_cnt, data_cnt);
uart_send_string(log_buf); // 统一发送
如果不用 sprintf，每次都要手写一长串 printf，格式还容易乱。
2、输出目标不一定是“屏幕”，可能是缓冲区/外设
嵌入式里，“打印”往往不是给人看的，而是给：
• 串口调试助手
• LCD/OLED 屏
• 文件系统 / Flash 日志区
• 网络 TCP/UDP 报文
这些接口通常只接受一段已经拼好的字符串或缓冲区指针，而不是 printf 那种可变参数调用。
典型做法：
char buf[64];
sprintf(buf, "temp=%dC", temp_val);
lcd_show_string(buf); // LCD 显示函数
save_to_flash(buf); // 存日志
send_to_uart(buf); // 串口发送
相当于先用 sprintf 把“内容”做好，再让不同模块去消费这段内容。
3、减少重复代码，提高可维护性
假设有多处要打印类似信息：
• 状态变化
• 错误码
• 传感器数据
如果到处写printf("Sensor %s: val=%d, err=%d\n", name, val, err);一旦格式要改（比如加时间戳、改分隔符），就要改很多地方。
用 sprintf 封装一下：
void sensor_log(const char *name, int val, int err)
{char buf[64];sprintf(buf, "[%s] Sensor %s: val=%d, err=%d", get_time_str(), name, val, err);uart_send_string(buf);
}
业务代码里只调用 sensor_log("TEMP", t, e);，格式统一、改起来只改一处。
4、便于“缓存/队列/批处理”输出
有些系统会先把若干条日志攒在缓冲区或消息队列里，等空闲时一起输出，减少频繁打扰主业务。
• 用 sprintf 把每条日志先变成字符串
• 把字符串指针/内容塞进队列
• 后台任务从队列取出来，统一 write/发送
如果直接用 printf，输出时机不好控制，而且难以做“批量发送”“重发失败包”等逻辑。
5、与 printf 实现成本有关（部分平台）
在一些资源非常紧张的 MCU 上：
• 完整的 printf 带浮点、格式解析，代码体积大
• 而 sprintf 配合一个极简的 puts/uart_write 更省空间
所以会：
• 用 sprintf 做格式化
• 用自写的小函数 my_puts(char *str) 发到串口，省掉标准库的 printf 实现
6、小结：什么时候用哪个？
• 直接 printf：
• 简单调试，信息量不大 • 只往标准输出（如 PC 端终端）打日志
• sprintf + 统一输出函数：
• 需要固定格式/协议/日志规范 • 要同时给 LCD、串口、Flash、网络 等多个目标用 • 需要缓存、队列、批处理、重发等机制 • 想让代码更易维护、易修改