C++标准库不提供按总宽度自动换行功能，必须手动实现：英文可按字符数切分并优先空格断行，中文等UTF-8文本需解码统计显示宽度，终端宽度需系统调用获取，输出时需显式添加换行符。
换行逻辑必须自己实现，标准库不提供
C++ 标准库（包括 std::string、std::ostream）本身没有「按总宽度自动换行」的内置函数。所谓“指定总宽度”通常指终端显示宽度（如 80 字符），但 C++ 不感知终端——它只管字符串内容和输出流。因此，换行必须手动切分字符串，再逐行输出。
关键点在于：你得决定「按字符数切」还是「按字节切」。英文文本可直接按字符数（ASCII 单字节），但中文等 UTF-8 文本中一个汉字占 3 字节，却只算 1 个显示宽度。若强行按字节截断，会破坏 UTF-8 编码，输出乱码。
- 纯 ASCII 文本：按
width字符数切分即可，用substr()+find_last_of(" ", pos)优先在空格处断行更自然 - 含中文/Unicode 文本：必须先做 UTF-8 解码，统计「显示宽度」（如汉字宽 2，ASCII 宽 1），再找断点——这需要第三方库（如
utf8cpp）或手写轻量解析 - 若目标是控制台输出且仅需近似效果，可用
std::cout.width()配合std::left，但它只影响单次输出对齐，不自动换行
最简可行方案：按空格折行，支持英文段落
对大多数日志、帮助文本等英文场景，以下函数足够用：输入字符串和最大宽度，返回每行不超过该宽度、尽量在空格处分割的 std::vector<std::string>：
std::vector<std::string> wrap_text(const std::string& s, size_t width) {
std::vector<std::string> lines;
std::string::size_type start = 0;
while (start < s.length()) {
if (s.length() - start <= width) {
lines.push_back(s.substr(start));
break;
}
auto end = start + width;
// 向前找最近空格
if (end < s.length() && s[end] != ' ') {
auto space = s.find_last_of(' ', end);
if (space != std::string::npos && space > start) {
end = space;
}
}
lines.push_back(s.substr(start, end - start));
start = end + 1; // 跳过空格
if (start < s.length() && s[start] == ' ') start++; // 连续空格跳过
}
return lines;
}注意：end 可能落在单词中间（当整词超宽时），此时强制截断；若某单词本身长度 > width，它会独占一行——这是合理行为，避免无限循环。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
终端宽度检测不能靠 C++ 标准库
想让换行宽度适配当前终端（比如用户缩放了窗口），C++ 本身无法获取终端列数。std::cout 不暴露这些信息。Linux/macOS 下需调用 ioctl(TIOCGWINSZ)，Windows 下用 GetConsoleScreenBufferInfo。跨平台项目常用 ncurses 或 termcap，但引入依赖较重。
- 快速验证：运行
stty size（Linux/macOS）或mode con（Windows）看当前尺寸 - 代码中硬编码宽度（如
80）仍是多数 CLI 工具的做法，稳定且可控 - 若真要动态获取，封装成独立函数（如
get_terminal_width()），失败时 fallback 到默认值（如72）
别忽略输出时的换行符和缓冲
即使字符串已按行切好，直接 std::cout << line 不会自动加 \n，除非你在每行末尾显式拼上。常见错误是忘了换行，导致所有行挤在同一行显示。
- 推荐写法：
for (const auto& line : wrapped) std::cout << line << '\n'; - 若使用
std::endl，会触发 flush，影响性能；纯输出场景用'\n'更合适 - 如果输出被重定向到文件，换行符仍是
\n（Unix 风格），Windows 控制台也能正确识别
真正容易被忽略的是：换行逻辑和实际显示效果之间隔着终端字体、全角/半角、是否启用 word-wrap 设置——这些不是 C++ 能控制的。你的函数只负责生成「逻辑分行」，最终怎么渲染，交给终端。
