C++如何计算字符串在终端显示的宽度（处理汉字）-C++-PHP中文网

终端显示宽度需用 wcwidth() 配合 mbstowcs() 计算，先设 utf-8 locale，再转换宽字符并累加有效宽度；否则汉字等会误算为 0；ansi 转义序列须过滤。

c++如何计算字符串在终端显示的宽度（处理汉字）

终端显示宽度 ≠ 字符个数，尤其涉及 UTF-8 和汉字

直接用 std::string::length() 或 strlen() 得到的是字节数，不是终端实际占的列宽。UTF-8 中一个汉字通常是 3 字节，但显示时只占 2 列（多数现代终端），英文字符占 1 列。更麻烦的是，有些符号（如 emoji、全角标点、组合字符）可能占 1/2/4 列不等，甚至跨行换行行为也会影响视觉宽度。

用 `wcwidth()` + `mbstowcs()` 逐字符计算最可靠

wcwidth() 是 POSIX 标准函数，专为解决“宽字符在终端占几列”而设计，能正确识别 ASCII（返回 1）、CJK 汉字（通常返回 2）、控制字符（返回 -1）、零宽字符（返回 0）等。但它只接受 wchar_t，所以需先将 UTF-8 字符串转为宽字符序列：

用 mbstowcs(nullptr, utf8_str.c_str(), 0) 获取所需宽字符缓冲区大小
分配 std::vector<wchar_t></wchar_t> 并调用 mbstowcs() 转换
遍历每个 wchar_t，累加 wcwidth(c)；跳过返回 -1 的控制字符（如 \t、\n）

示例关键片段：

#include <cstdlib>
#include <vector>
#include <string>
#include <cwchar>

int terminal_width(const std::string& s) {
    if (s.empty()) return 0;
    int wlen = mbstowcs(nullptr, s.c_str(), 0);
    if (wlen == -1) return 0; // 无效 UTF-8
    std::vector<wchar_t> wbuf(wlen + 1);
    mbstowcs(wbuf.data(), s.c_str(), wlen);
    int width = 0;
    for (int i = 0; i  0) width += w;
    }
    return width;
}
</wchar_t></cwchar></string></vector></cstdlib>

注意 locale 设置，否则 `wcwidth()` 默认按 C locale 返回错误值

wcwidth() 行为严重依赖当前 C locale。若未显式设置，程序默认使用 "C" locale，此时所有非 ASCII 字符（包括汉字）都返回 -1 —— 导致宽度算成 0。必须在调用前设为支持 UTF-8 的 locale：

C函数速查手册（CHM版）

下载

Linux/macOS：用 setlocale(LC_CTYPE, "en_US.UTF-8") 或 ""（读取环境变量）
Windows：setlocale(LC_CTYPE, ".UTF8") 或 "Chinese_China.65001"
务必在 main() 开头尽早调用，且不要在多线程中随意切换 locale

漏掉这步是实践中最常踩的坑，现象是：汉字全被算成 0 宽度，导致对齐错乱、截断异常。

替代方案：用 `utf8cpp` 库手动解析 UTF-8 码点再查 `uc_width()`

如果不能依赖系统 setlocale()（比如嵌入式环境或沙箱限制），可绕过 locale，直接解析 UTF-8 字节流，转换为 Unicode 码点（uint32_t），再用第三方宽字符宽度表判断。推荐轻量库 utf8cpp（头文件 only）配合 uniset 或手写简版码点宽度映射：