C语言如何解决printf用%s格式符输出UTF-8字符串宽度计算错误问题

问题根因 #

C标准库printf的%Ns格式符默认按字节数统计宽度，而非字符的实际显示宽度。你测试用的δ是UTF-8编码的多字节字符，占2个字节，ASCII字符w仅占1个字节，所以同样用%5s时，虽然总字节数满足要求，但视觉显示宽度不一致。

解决方法 #

方法一：使用宽字符输出（最简便） #

切换为宽字符串和wprintf函数，配合%ls格式符，会按字符数统计宽度，实现对齐：

#include <stdio.h>
#include <wchar.h>
#include <locale.h>

int main(void){
    // 初始化本地化适配当前系统的UTF-8环境，必须加
    setlocale(LC_ALL, "");
    printf("<0123456789> BOTH <%%5ls>\n");
    wprintf(L"<%5ls>\n", L" w ");
    wprintf(L"<%5ls>\n", L" δ ");
    return 0;
}

编译运行后两个字符串的视觉宽度完全一致，对齐效果符合预期。

方法二：手动补空格（兼容旧代码） #

如果不方便修改原有代码的字符串类型，可以自己实现UTF-8字符串显示宽度统计函数，计算需要补充的空格数手动填充：

• UTF-8编码规则：单字节字符最高位为0，多字节字符的首字节最高位连续1的个数就是该字符的字节数，按这个规则遍历字符串统计实际显示的字符总数
• 输出时先打印原字符串，再补（目标宽度 - 实际字符数）个空格即可

注意事项 #

• 源码需要保存为UTF-8编码，运行程序的终端也需要设置为UTF-8编码，避免出现乱码
• 主流编译器（GCC、Clang、MSVC）均默认支持宽字符接口，无需额外配置编译参数

内容的提问来源于stack exchange，提问作者Diego Saravia