需手动实现按字符宽度截断换行：先按unicode或ascii字符逐个累加宽度，达列宽时插入换行符并补缩进；禁用字节切分以防utf-8乱码，避免断词。
如何用 std::string 手动实现按宽度截断+缩进换行
标准 C++ 没有内置的「自动换行」函数，std::string 本身也不处理排版逻辑。必须自己拆分字符串——核心是按 Unicode 字符（非字节）或 ASCII 字符逐个累加宽度，达到指定列宽时插入换行符，并在后续行前补上缩进字符串。
常见错误是直接按字节数切分（比如用 substr(0, width)），这在 UTF-8 下会截断多字节字符，导致乱码；另一坑是忽略空格连贯性，把单词硬生生从中间劈开。
- 按字符而非字节遍历：用
std::mbstowcs或 C++11 的std::codecvt_utf8（已弃用，推荐用第三方如 utf8cpp 或手动解析 UTF-8）；若只处理 ASCII，可用for (size_t i = 0; i - 保留单词完整性：遇到空格/制表符/换行符时检查当前行长度 + 下一单词长度是否超限，超了就换行再塞单词
- 缩进只加在第二行及以后：第一行不加，后续每行开头拼接缩进字符串（如
" "或"→ "）
std::stringstream 和 std::setw 能不能用来做自动换行？
不能。std::setw 只影响单次输出宽度，且仅对下一个插入操作生效；std::stringstream 是流式缓冲，不提供“回溯重排”能力。试图用它控制换行，结果往往是整段挤在一行，或者靠 \n 硬塞导致缩进错位。
典型误用：
std::stringstream ss;
ss <p>真正需要的是状态机式的处理：记录当前行已用宽度、是否刚换行、下一个字符是否为分词边界。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册（CHM版）"><img
src="https://img.php.cn/upload/manual/000/000/001/5d6de31fedca2993.png" alt="C函数速查手册（CHM版）" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册（CHM版）" class="overflowclass">C函数速查手册（CHM版）</a>
<p class="overflowclass">C函数速查手册（CHM版）</p>
</div>
<a rel="nofollow" href="/xiazai/shouce/1510" title="C函数速查手册（CHM版）" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><h3>一个轻量可复用的 C++17 实现示例（ASCII 安全版）</h3><p>以下函数支持英文/数字/基础符号，不依赖 ICU，兼容 MSVC/GCC/Clang：</p><pre class="brush:php;toolbar:false;">std::string wrap_text(const std::string& text, size_t width, const std::string& indent = "") {
if (width == 0) return text;
std::string result;
size_t pos = 0, line_start = 0;
while (pos line_start) {
end = last_space;
}
}
// 写入当前行（首行无缩进，后续加 indent）
if (line_start == 0) {
result += text.substr(line_start, end - line_start);
} else {
result += "\n" + indent + text.substr(line_start, end - line_start);
}
line_start = end;
while (line_start <p>注意：<code>width</code> 是显示宽度（ASCII 下 ≈ 字符数），不是字节数；缩进字符串 <code>indent</code> 会出现在每行开头（除第一行），且不参与宽度计算。</p><h3>UTF-8 字符串换行为什么不能简单用 <code>.size()</code>？</h3><p>因为 <code>std::string::size()</code> 返回字节数，而一个中文字符在 UTF-8 中占 3 字节，一个 emoji 可能占 4 字节。按 <code>size()</code> 截取 10 就可能只拿到 3 个汉字，还可能卡在某个汉字中间，解码失败。</p><p>如果必须支持 UTF-8，有两条路：</p>
- 用
utf8::distance(s.begin(), s.end())（需 utf8cpp 库）获取真实字符数，再逐字符累加显示宽度（中文/emoji 通常算 2 宽，ASCII 算 1） - 放弃精确宽度控制，改用「按字节安全截断」：找到小于等于
width的最大合法 UTF-8 结尾位置（检查尾字节是否符合 0xC0–0xFF、0x80–0xBF 模式）
多数终端和日志场景其实只需要 ASCII 安全，强行上 UTF-8 宽度计算反而增加依赖和运行时开销，先确认真实需求再决定是否引入 utf8cpp 或 ICU。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
