折行应优先在空格、标点或 Unicode 词边界处断开，避免劈开单词；需按显示宽度（ASCII 算1，中文等宽字符算2）累计列宽，遇超限则回退至最近安全断点插入 \n；封装时用结构体传递配置，并预处理制表符、保留缩进、逐行处理原有换行。
折行逻辑怎么写才不切单词
直接按字符数截断会把英文单词或中文词组硬生生劈开，用户看到的是“inter-”“nation-”这种奇怪断点。核心是得在空格、标点或 Unicode 词边界处折行，而不是无脑数字符。
实际做法是：遍历字符串，累计当前行宽度（按字符数或真实像素宽），遇到空格或中文字符时记录可断点位置；当累计宽度超限，就回退到最近一个可断点处插入换行符 \n，再从下个字符重新计数。
- 对纯 ASCII 文本，用
isspace()判断空格、制表符等作为安全断点 - 处理中文需依赖
std::iswspace()或更稳妥地用 ICU 库识别 Unicode 分隔符，但多数终端场景用 UTF-8 字节长度 + 基础空格判断已够用 - 避免在连字符
-后强行断开（如 “C++”、“user-defined”），可在断点判断里加条件：前一个字符不是-且后一个字符不是-
列宽单位用字符数还是像素？
终端输出基本都用字符数——因为 std::cout、printf 和大多数日志系统只认字节数/码位数，不感知字体渲染。除非你是在 Qt 或 SDL 这类 GUI 框架里做文本框排版，否则别碰像素。
注意：UTF-8 中一个中文字符占 3 字节，但显示宽度是 2 个英文字符宽（全角）。所以严格来说，列宽应按“显示宽度”算，而非字节数。简单方案是：遍历每个 UTF-8 字符，用 utf8cpp::utf8to32() 转成 Unicode 码点，再查 u_iswide()（ICU）或手动判断范围 0x4E00–0x9FFF 等来区分宽窄字符。
- 若只要求兼容英文+常见中文，可简化：ASCII 字符（
0x00–0x7F）算 1 宽，其余 UTF-8 多字节序列统一算 2 宽 - 别用
std::string::length()当列宽——它返回字节数，中文会严重低估显示宽度 - Windows 控制台默认不支持 UTF-8 宽字符检测，需先调用
SetConsoleOutputCP(CP_UTF8)
std::string 折行函数怎么封装才好复用
别写成全局函数塞一堆参数，容易传错顺序。推荐用结构体封装配置，明确语义：
struct TextWrap {
size_t width = 80;
char break_char = '\n';
bool preserve_words = true; // 是否禁止切单词
};
std::string wrap_text(const std::string& text, const TextWrap& opt);
关键细节：
- 输入字符串含已有
\n时，要先按行分割，再对每行单独折行，不能整段 flatten 处理 - 保留原始缩进：遇到行首空格，折行后新行也补同样空格，否则代码块排版全乱
- 如果输入含制表符
\t，需提前展开为 4 或 8 个空格，否则宽度计算失准 - 返回值别用
std::string&引用——内部要新建字符串，引用返回悬垂指针
为什么 std::ostringstream 里拼接折行结果会出问题
不是所有流操作都支持嵌入 \n 后还能保持格式稳定。比如把折行后的字符串喂给 std::ostringstream 再转 .str()，看起来没问题；但若后续用 fmt::format() 或某些日志宏处理，可能把 \n 当普通字符吞掉，或被二次转义。
更隐蔽的问题是：有些终端模拟器（如 Windows Terminal 的旧版本）对连续多个 \n 渲染异常，或把行首空格吃掉。所以折行函数输出后，建议立刻用 std::cout 直接验证，别绕流中间层。
- 调试时用
std::cout.write(result.data(), result.size())避免operator 的隐式格式化干扰 - 单元测试必须覆盖边界：空字符串、单字符、刚好满宽、超长无空格字符串（此时只能硬切）
- 性能敏感场景避免反复
substr()和append()，改用reserve()预分配 +back_inserter构建结果
折行看着简单，真正落地时宽字符处理、已有换行的嵌套、缩进继承这三处最容易漏测。别信“能跑就行”，终端排版错一点，用户第一眼就觉着不专业。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
