折行需先明确定义“单词”和“宽度单位”，C++标准库无内置行断逻辑，应基于字符集（如UTF-8）和策略（保词/字断/连字符处理）流式扫描找断点，避免预分割与字节截断，宽度须按视觉列宽（非字节）计算。
折行前必须先定义“单词”和“宽度单位”
主流标准（如 CSS word-wrap: break-word、Unicode Line Breaking Algorithm）默认以空格/标点为词界，但 C++ 标准库不内置行断逻辑。直接用 std::string::find_first_of(" \t\n\r") 分词看似简单，却会错误切分连字符词（如 "co-operate"）、中英文混排（如 "Hello世界"）或 URL（"https://example.com/path?x=1"）。真正可用的起点是：明确你支持的字符集（ASCII / UTF-8 / ICU）和折行策略（优先保词 / 允许字断 / 保留连字符）。UTF-8 下单个中文字符占 3 字节，但视觉宽度≈1 英文字符，不能按 byte 数截断。
用 std::string_view + 手动扫描实现轻量级词边界识别
不依赖 ICU 或 Boost.Text 的纯 C++17 方案，核心是跳过空白、识别可断点、累积视觉宽度。关键不是“分词”，而是“找断点”：
-
isspace()只对 ASCII 空格安全；UTF-8 中需用std::iswspace配合std::mbtowc，但性能差；更实用的是预定义空白集合：std::string_view space_chars = " \t\n\r\u3000";（含中文全角空格） - 英文单词内断点：允许在
'-'后断（如"re-arrange"），但禁止在"e-mail"的'-'前断 —— 需检查前后字符是否为字母 - 中日韩文字：每个字符可视作独立断点（无词概念），但需避免在 GBK/UTF-8 多字节序列中间截断 —— 必须按合法 UTF-8 code point 边界切分，可用
utf8cpp::next()或手动验证首字节
示例片段（仅示意逻辑，不含 UTF-8 解码）：
size_t find_break_point(std::string_view s, size_t start, int max_width) {
int width = 0;
size_t i = start;
while (i < s.size() && width < max_width) {
if (is_space_or_breakable(s[i])) { // 包含 ' ', '-', '\u3000' 等
if (width + char_width(s[i]) > max_width) break;
return i; // 空格或连字符位置可断
}
width += char_width(s[i]);
i++;
}
return (width >= max_width) ? start : std::string_view::npos;
}
避免 std::stringstream 按空格分割再拼接的陷阱
常见错误是把整段文本用 std::istringstream 拆成 vector<string>，再逐个累加长度判断换行 —— 这会丢失原始空白（多个空格变一个）、破坏缩进、无法处理换行符保留需求，且无法在单词内部断（如超长 URL）。更严重的是：当某单词本身长度 > max_width 时，这种方案直接卡死或崩溃。正确做法是流式扫描，边读边判断，每遇到潜在断点就检查当前累计宽度是否超限，超限则在此处插入 '\n' 并重置计数。
立即学习“C++免费学习笔记（深入）”；
- 不要预分割：保留原始
std::string_view引用，避免拷贝开销 - 不要假设单词长度 ≤ 宽度：对超长串（如 base64、URL）必须启用字断（character breaking），即按字符（非字节）强制截断
- 注意 Windows 行尾：
"\r\n"占 2 字节但视觉宽度为 0，不应计入max_width
实际部署时最易被忽略的细节
字体渲染和终端宽度不等于字符数：等宽字体下 1 个 ASCII 字符 = 1 列，但中文、emoji 通常占 2 列（wcwidth() 返回 2），而某些组合字符（如带声调的拉丁字母）可能返回 0。若目标是控制台输出，必须用 libunistring 或 std::wstring_convert（已弃用，慎用）获取真实列宽；若用于 GUI 渲染，则应交由 Qt 的 QFontMetrics::horizontalAdvance() 或 Skia 的 SkPaint::measureText() 处理 —— C++ 层只负责语义断点，不负责像素级测量。
真正的难点不在算法，而在定义清楚“宽度”是谁的宽度、谁来测量、误差容忍多少。没对接具体渲染后端之前，所有“自动折行”都是模拟。
