textwrap.fill()返回换行字符串，textwrap.wrap()返回行列表；中文错位因按字符而非显示宽度计数；需用wcwidth等修正；保留缩进用initial_indent等参数；大文本卡顿应关闭break_long_words并预处理。
textwrap.fill() 和 textwrap.wrap() 有什么区别？
核心区别在于返回值：textwrap.fill() 返回单个换行后的字符串，textwrap.wrap() 返回按行切分的字符串列表。多数场景下直接用 fill() 更省事——比如打印日志、生成报告文本；只有需要逐行处理（如加序号、高亮某行）时才选 wrap()。
常见错误是把 wrap() 的结果直接 print，结果看到的是带方括号和引号的列表形式，而不是换行效果。
-
textwrap.fill("Hello world", width=5)→"Hello\nworld" -
textwrap.wrap("Hello world", width=5)→["Hello", "world"]
中文文本换行为什么经常错位或截断字？
textwrap 默认按字符（character）计数，对 ASCII 没问题，但中文每个字算 1 个字符，而实际排版中常需按「显示宽度」对齐（比如一个中文字符占 2 个英文字符宽度）。模块本身不处理 Unicode 显示宽度，所以设 width=20 时，若原文含 12 个汉字 + 8 个英文字母，可能撑出边界或在中间硬拆字。
解决方法不是改 width，而是预处理：用 unicodedata.east_asian_width() 或第三方库（如 chardet 不适用，推荐 wcwidth）修正长度计算。简单应对可先用 re.sub(r'([\u4e00-\u9fff])', r' ', text) 在中文后加空格辅助断行（副作用是多空格，适合非严格排版）。
如何保留段落缩进与空行？
textwrap.fill() 默认会把首行缩进吃掉，且合并连续空行。关键参数是 expand_tabs、replace_whitespace 和 drop_whitespace，但真正控制段落结构的是 initial_indent 和 subsequent_indent，以及必须设 break_on_hyphens=False 防止连字符误断。
- 保留每段首行缩进 4 空格：
initial_indent=" " - 后续行缩进 2 空格：
subsequent_indent=" " - 维持原文空行：
textwrap.fill(text, width=50, replace_whitespace=False, drop_whitespace=False)，但注意这可能导致超宽行——空行本身不参与 width 计算，所以安全
性能差、大文本卡顿怎么办？
textwrap 是纯 Python 实现，对几 MB 的文本做 fill() 可能明显延迟，尤其启用了 break_long_words=True（默认）时，内部会反复切分长单词。实测 10MB 纯英文文本在普通笔记本上耗时约 1.2 秒；含大量无空格长串（如 base64、URL）时可能升至 5 秒以上。
优化方向很明确：关掉长词拆分 + 预过滤。如果业务允许截断超长 token，设 break_long_words=False 并配合 max_lines 和 placeholder="…"；更激进的做法是先用正则把 >50 字符的连续非空白串替换为缩略形式，再进 fill()。
别试图用 io.StringIO 或 linecache 加速——textwrap 不走流式处理，预处理才是瓶颈所在。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
