正确折行需先转为std::wstring，用std::iswspace判断空格，非空格段整体保留；按Unicode码位计算显示宽度（ASCII占1格、中文等占2格），避免UTF-8字节切分导致乱码。
折行逻辑必须避开英文连字符和中文标点断开
直接按空格切分再拼接，会在中英文混排时把“C++”切成“C”和“++”，或把“（示例）”拆成“（”和“示例）”，导致显示错乱。正确做法是：优先以空格为断点，但遇到 std::iswspace 返回 false 的连续非空白字符（如英文单词、中文词、符号组合），需整体保留，不能中间截断。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
std::wstring_convert或 C++17 的std::from_chars（若输入为 UTF-8）先转成std::wstring，确保每个wchar_t对应一个 Unicode 码位（尤其处理中文） - 遍历每个字符，调用
std::iswspace(c)判断是否为空格；对非空格段，用std::mbrtowc或 ICU 库做字边界检测（简单场景可跳过，但长中文段需防在“你好世界”中间折行） - 记录上一个安全断点位置（即最近一次空格或中文标点后），当当前累计宽度 > 目标列宽时，回退到该位置换行
列宽计算不能只数字符个数
ASCII 字符占 1 格，中文、全角标点、Emoji 占 2 格（在等宽字体下），而某些宽字符（如 ?）可能占 4 格。用 str.length() 当列宽会严重误判。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用
std::wcswidth计算每个wchar_t的显示宽度（注意：它不支持 UTF-8，必须传wchar_t*） - 对无法识别的字符（返回 -1），统一按 1 格处理（避免崩溃），或改用
libunistring的u8_width - 维护运行累计宽度变量
current_width，每次加新字符前先检查current_width + next_char_width ，否则插入 <code>'\n'并重置
如何处理超长单词（如 URL 或技术标识符）
当单个单词（如 https://example.com/very-long-path-to-resource）宽度远超 max_width，硬性不断行会导致溢出。此时需启用“强制折行”，但不能在任意位置切——比如不能把 std::vector 拆成 std::vec 和 tor。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 对长度 >
max_width的单词，优先在连接符处折行：/、-、_、.（URL 中常见），使用std::find_first_of(word, "/-_.") - 若无连接符，退而求其次在字母与数字交界处（如
v123abc→v123+abc），用std::isalpha和std::isdigit判断 - 极端情况（纯字母超长串），每
max_width - 1个字符后加'-'再换行（如排版引擎常用 soft hyphen 逻辑）
std::string vs std::wstring：选错会导致折行错位
用 std::string 处理 UTF-8 输入时，一个中文字符占 3 字节，.length() 返回 3，但显示只占 2 格；直接按字节切会把 UTF-8 编码截断，产生乱码 \xef\xbf\xbd。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 输入确定为 UTF-8？→ 转
std::wstring再处理（Windows 下可用MultiByteToWideChar，Linux/macOS 用std::wstring_convert已弃用，改用iconv或手动解析） - 若只处理 ASCII+少量中文，且列宽要求不高，可用
utf8cpp库的utf8::distance获取字符数，再配合utf8::next逐字符迭代 - 绕过宽字符：直接操作 UTF-8 字节流，用
utf8::is_leadbyte判断是否为多字节字符起始，确保不切断编码单元
最易被忽略的是：不同平台 std::wcswidth 对 Emoji 的支持程度差异很大，macOS 支持较好，Linux glibc 旧版本可能返回 -1，得准备 fallback 逻辑。
