“按字截断”指在指定长度内于空白或字符边界处截断字符串，避免撕裂单词；英文用空格定位断点，中日韩需Unicode字位检测，否则易乱码。
什么是“按字截断”？先明确需求边界
C++里没有内置的“按字（Word）截断”概念——它取决于你指的“字”是空格分隔的单词（English-style），还是 Unicode 字符/汉字（CJK-style）。多数人实际要的是：给定最大宽度（如 20 个字符或像素），把字符串在空白处或字符边界处折行，不撕裂单词。但 std::string 本身不带布局逻辑，得自己判断断点。
关键判断：如果你处理的是英文文本，靠空格 + find_last_of(" \t\n\r") 就够用；如果是中日韩，必须用 Unicode 边界检测（比如 ICU 或 C++20 的 std::ranges::is_grapheme_cluster_break），否则在汉字中间截断会出乱码或显示异常。
英文场景：用 find_last_of 找最近空格断开
适用于纯 ASCII 或 UTF-8 编码下、单词由空格/制表符分隔的文本。注意：不能直接用 substr(0, n) 截前 n 字符，否则可能把单词劈开。
实操建议：
- 先检查第
n个字符是否为空白——如果是，直接substr(0, n) - 否则从位置
n往前找第一个空格：s.find_last_of(" \t\n\r", n) - 如果找到（返回值 !=
std::string::npos），取substr(0, pos)；否则硬截（保留完整单词） - 记得处理首尾空白：截完后用
erase(0, s.find_first_not_of(" \t\n\r"))和erase(s.find_last_not_of(" \t\n\r") + 1)清理
std::string truncate_at_word(const std::string& s, size_t max_len) {
if (s.length() <= max_len) return s;
size_t pos = s.find_last_of(" \t\n\r", max_len);
if (pos == std::string::npos) return s.substr(0, max_len);
return s.substr(0, pos);
}
中文/日文/韩文：别用 find_last_of，会切错字
UTF-8 下一个汉字占 3 字节，substr(0, 10) 可能停在某个汉字中间，导致后续解码失败（显示 或乱码）。更糟的是，有些字形组合（如 emoji ZWJ 序列）需要整组处理。
正确做法：
- 用
std::string_view配合 UTF-8 解码库（如utf8cpp）遍历 code point，累计字数（不是字节数） - 或改用
std::wstring+std::locale（但 Windows 和 Linux 的std::locale("")行为不一致，慎用） - C++20 起可尝试
std::ranges::distance+std::text::grapheme_cluster_iterator（尚未广泛支持） - 生产环境推荐直接调用 ICU 的
BreakIterator，它专为多语言断行设计
简单 fallback 方案（仅限已知安全编码）：按 UTF-8 字节序判断是否为合法字符起始（高位为 0xxxxxxx、110xxxxx、1110xxxx、11110xxx），再往回跳到最近合法起点——但这不保证语义正确（比如不能在连字中间断）。
立即学习“C++免费学习笔记（深入）”；
性能与边界情况提醒
每次截断都做一次反向扫描，对长字符串高频调用会慢。如果需反复截断同一字符串（如富文本渲染），建议预计算所有空格/换行位置存入 std::vector<size_t></size_t>，用二分查找加速。
- 空字符串、全空白字符串要单独判，否则
find_last_of返回npos导致越界 - UTF-8 中 BOM（
\xEF\xBB\xBF）需提前剥离，否则影响字节计数 - Windows 控制台默认不支持 UTF-8 输出，
SetConsoleOutputCP(65001)必须显式调用 - GUI 框架（Qt、ImGui）通常自带 word-wrap，优先用它们的 API，别自己实现
