用 std::istringstream 分词+贪心拼接是处理纯ASCII英文文本最可靠的自动折行起点，它自动跳过连续空白、统一处理空格制表符换行符，且通过 iss >> word 读取单词并正确拼接带空格的行。
直接用 std::string::substr 按固定字节数切，一定会劈开单词或 UTF-8 字符，不符合主流排版标准。真正合规的自动单词折行，必须在空格、制表符、换行符等分隔位置断行，且对超长单词保留完整、对中文等宽字符按显示宽度计数——C++ 标准库不提供现成函数，得手写逻辑，但关键不是算法多复杂，而是宽度计算和断点判断是否安全。
用 std::istringstream 分词 + 贪心拼接是最稳的起点
这是处理纯 ASCII 英文文本最可靠的方式，它自动跳过连续空白、统一处理 ' '、'\t'、'\n'，不会因多空格或首尾空格出错。
-
iss >> word是核心：它读到下一个空白就停，且不把空格塞进word里 - 拼接时，首词直接赋值；后续每加一个词，必须先加
" "再加词，否则变成"helloworld" - 判断条件不是
line.length() + word.length() ，而是 <code>line.length() + 1 + word.length() （那个 <code>+1是空格） - 别忘了循环结束后 push 剩余
line，否则最后一行丢掉
超长单词（word.length() > max_width）不能忽略，但也不该默认硬切
主流排版行为（如终端、printf、Qt 文本框）默认让超长单词独占一行——这不是 bug，是 feature。强行切分会破坏 URL、文件路径、技术术语可读性。
- 若你确实需要强制折断（比如日志截断），必须加开关控制，例如
bool force_break = false - 启用后，切分前必须确保不在 UTF-8 多字节中间：用
std::mbrlen或utf8cpp::next找合法码点边界，不能直接substr(i, max_width) - ASCII 场景下可直接切，但函数接口要注明 “仅限单字节编码”，否则调用方误用于中文会出乱码
中文/中英混排必须按显示宽度算，std::string::length() 是陷阱
std::string::length() 返回字节数，UTF-8 编码下汉字是 3 字节，但显示宽度是 2 列（等宽字体惯例）。拿它当列宽用，一行实际显示会严重溢出。
立即学习“C++免费学习笔记（深入）”；
- 简单方案：遍历每个 UTF-8 字节序列，用
std::mbrtowc解码为wchar_t，再调wcwidth获取显示宽度（注意 locale 必须设为 UTF-8） - 轻量替代：对每个字节检查高位，
0x00–0x7F算 1 宽，0xC0–0xFF开头的多字节序列统一算 2 宽（覆盖大部分中日韩字符） - Windows 控制台需提前调
SetConsoleOutputCP(CP_UTF8)，否则wcwidth返回 -1
别在热路径反复构造 std::string 和 std::istringstream
高频调用（如 UI 渲染帧循环）中，每次调用都 new buffer、parse、copy，性能会明显下滑。
- 改用指针扫描原字符串：记录空格位置索引，避免
std::istringstream构造开销 -
std::string_view替代std::string参数，避免传参拷贝 - 预分配输出容器：
lines.reserve(text.length() / max_width + 1) - 宽度缓存只对静态文本有效；动态内容（如实时日志）别缓存，反而增加哈希查找开销
真正难的从来不是“怎么换行”，而是“宽度怎么算”——一旦遇到 emoji、ZWJ 序列、组合字符，wcwidth 就不可靠，这时候就得上 ICU 或接受降级处理。别指望一个函数通吃所有 Unicode 边界场景。
