核心区别在于返回值：textwrap.fill()返回单个换行后的字符串，textwrap.wrap()返回按行切分的字符串列表；前者适合直接输出日志或API响应，后者适合逐行处理如加序号或前缀。
textwrap.fill() 和 textwrap.wrap() 的核心区别在哪？
直接用 textwrap.fill() 处理日志或 API 响应体最省事，它返回单个字符串；而 textwrap.wrap() 返回行列表，适合需要逐行加前缀（比如日志时间戳）的场景。别在循环里反复调用 fill() —— 它内部已做高效分词，重复调用反而破坏换行一致性。
常见错误：把带缩进的原始文本直接喂给 fill()，结果首行缩进被保留，后续行没对齐。正确做法是先用 textwrap.dedent() 清除原始缩进，再统一加新缩进。
-
width=80是默认值，但生产环境建议显式指定，避免不同 Python 版本或终端宽度影响输出 -
break_long_words=False必须设为False处理 URL 或 base64 字符串，否则会在中间硬切，导致内容损坏 -
replace_whitespace=True（默认）会把所有空白（包括制表符、多个空格）转成单空格，若需保留格式（如代码片段），得设为False并配合drop_whitespace=False
如何给每行添加固定前缀（比如「[INFO] 」）？
别用字符串拼接 + fill()，前缀会挤占有效宽度，导致实际换行点偏移。正确方式是用 initial_indent 和 subsequent_indent 参数：
import textwrap
text = "This is a very long line that needs wrapping and prefixing for logging."
wrapped = textwrap.fill(
text,
width=50,
initial_indent="[INFO] ",
subsequent_indent=" " # 注意：这里必须是空格，不是 \t
)注意：subsequent_indent 只接受字符串，不能是函数或变量。如果前缀长度动态变化（比如不同日志级别），得先计算最大前缀宽度，再统一传入。
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
立即学习“Python免费学习笔记（深入）”；
- 前缀里的空格数必须和
initial_indent长度一致，否则视觉错位 - 若前缀含非 ASCII 字符（如 emoji 或中文），
width计算仍按 Unicode 码点数，不是显示宽度，可能导致截断异常 - 在 Windows 控制台输出时，某些字体下中文字符占位不一致，建议搭配
len(text.encode('utf-8'))做宽度假设校验
处理含 ANSI 转义序列的文本（如彩色日志）时怎么避免乱码？
textwrap 会把 \x1b[32m 这类控制符当普通字符计数，导致换行位置错误、颜色失效甚至终端解析崩溃。必须先剥离控制序列再 wrap，再重新注入：
import re
import textwrap
<p>def strip_ansi(s):
return re.sub(r'\x1b[[0-9;]*m', '', s)</p><p>raw = "\x1b[32mSUCCESS\x1b[0m: Operation completed in 2.3s"
clean = strip_ansi(raw)
wrapped = textwrap.fill(clean, width=40)</p><h1>再手动补回颜色 —— 通常只在首行加，后续行保持无色</h1><p>result = f"\x1b[32m{wrapped.splitlines()[0]}\x1b[0m" + "\n".join(wrapped.splitlines()[1:])- 正则
r'\x1b\[[0-9;]*m'只覆盖基础颜色序列，不处理光标移动等复杂指令；生产环境建议用ansiwrap库替代 - 不要对整个带色文本调用
dedent()，ANSI 序列可能藏在缩进空格里，dedent()会误删 - 某些日志框架（如 structlog）自带 ANSI 感知的格式化器，优先用它们而非手写
textwrap
为什么在 Docker 容器里 textwrap 行为不一致？
根本原因是 locale.getpreferredencoding() 在容器中常为 ANSI_X3.4-1968（即 ASCII），导致 textwrap 对非 ASCII 字符（如中文、emoji）的宽度判断失准。现象是中文被当单字节计数，一行塞进太多字后突然折行。
- 启动容器时加
ENV LANG=C.UTF-8或LC_ALL=C.UTF-8，强制 UTF-8 编码 - Python 3.7+ 支持
textwrap.shorten()，但它也受 locale 影响，同样要配环境变量 - 若无法改容器环境，临时方案：用
len(s.encode('utf-8'))替代len(s)估算显示宽度，再按比例缩放width参数
真正难搞的是混合中英文 + 数字 + 标点的段落，textwrap 没有字体渲染能力，它只数字符——这点在生成 PDF 或 HTML 报告时尤其容易翻车。
