C++中中文截取错位因std::string是字节容器，UTF-8下中文占3字节，substr按字节截易切断字符；需用utf8cpp或ICU按Unicode码点或显示宽度安全截取。
中文字符在 C++ 中为什么截取会错位
因为 std::string 是字节容器，不是字符容器。UTF-8 编码下，ASCII 字符占 1 字节，中文通常占 3 字节，substr(0, 5) 截的是前 5 个字节，可能切在某个中文字符中间，导致乱码或 std::runtime_error（某些库校验 UTF-8 时）。
直接用 std::string::substr 处理中英文混合文本，本质是在操作字节流，不是视觉宽度或逻辑字符数。
- Windows 控制台默认 ANSI 编码（如 GBK），Linux/macOS 默认 UTF-8 —— 同一段代码行为可能不同
-
std::string::length()返回字节数，不是“几个字” - 没有内置函数能直接按「显示宽度」截取：中文算 2 单位、英文算 1 单位（类似终端列宽）
用 ICU 或 utf8cpp 做 Unicode 安全截取
靠自己解析 UTF-8 很容易漏掉代理对或损坏序列。推荐轻量级方案：utf8cpp（头文件库，无依赖）或系统级 ICU（功能全但重）。两者都能把字节串转成 std::vector<uint32_t>（即 Unicode 码点），再按码点数截取。
示例（utf8cpp）：
立即学习“C++免费学习笔记（深入）”；
#include <utf8.h>
#include <vector>
#include <string>
std::string safe_substr_utf8(const std::string& s, size_t char_count) {
std::vector<uint32_t> cp;
utf8::utf8to32(s.begin(), s.end(), std::back_inserter(cp));
if (char_count > cp.size()) char_count = cp.size();
std::string out;
utf8::utf32to8(cp.begin(), cp.begin() + char_count, std::back_inserter(out));
return out;
}
- 别用
utf8::distance直接算长度再截——它不保证截断点是合法 UTF-8 边界 - 若需按「显示宽度」（非码点数）截取，得额外查
ucd/emoji-data.txt或调用ICU u_getIntPropertyValue(c, UCHAR_EAST_ASIAN_WIDTH) - gcc/clang 下编译需加
-std=c++17，utf8cpp 不支持 C++11 以下
按终端列宽截取中英文混合字符串
终端里一个中文占 2 列、一个 ASCII 字符占 1 列。要实现 truncate_to_width("hello你好", 6) → "hello你"，不能只看码点数，得查每个字符的 East Asian Width 属性。
最简可行方案：用 ICU 的 u_getIntPropertyValue 判断宽度：
int get_char_width(char32_t c) {
auto w = u_getIntPropertyValue(c, UCHAR_EAST_ASIAN_WIDTH);
return (w == U_EA_W || w == U_EA_F || w == U_EA_A) ? 2 : 1;
}
-
U_EA_A（Ambiguous）在终端里通常按 2 处理，但有些环境当 1 —— 需和目标终端对齐 - emoji 可能返回
U_EA_N（Narrow），但实际渲染占 2 列，需单独处理UCHAR_GRAPHEME_CLUSTER_BREAK - 不引入 ICU？可硬编码常见中文/日文/韩文字母范围（如
0x4E00–0x9FFF），但漏掉扩展 B/C 区、标点、平假名片假名
std::wstring 在 Windows 上的坑
有人想绕过 UTF-8 复杂度，改用 std::wstring + MultiByteToWideChar。这在 Windows 上看似能“按字符截”，但问题不少：
-
wstring::length()返回wchar_t个数，而 Windows 的wchar_t是 UTF-16，中文可能占 1 个（BMP）或 2 个（代理对），substr(0,5)仍可能切在代理对中间 - Linux/macOS 的
wchar_t通常是 UTF-32，但std::wcout默认不工作，需std::locale::global配置，且终端未必支持 - 跨平台项目混用
string/wstring，IO 和网络层极易出编码错乱，比如fopen("中文.txt", "r")在 Windows 上失败
真正需要宽字符时，优先走 std::u16string + std::from_chars / std::to_chars（C++17+），避免 wstring 的平台语义分裂。
最麻烦的不是怎么截，而是截完之后要不要补省略号（"…"）、补多少字节才不破坏 UTF-8；以及“宽度”定义是否包含 ANSI 转义序列（比如 \033[31m红\033[0m）——这些细节一旦漏掉，肉眼看着对，实际在 tmux 或 vim 内嵌终端里就错位。
