Python textwrap.shorten 长字符串只剩省略号，怎样保留前缀

textwrap.shorten("x" * 30, width=10) 只返回 [...]，没有保留任何 x。如果你用它显示长编号、哈希或没有空格的标识，应先确认需要的是“按词缩短”，还是“保留固定长度前缀”。

shorten() 会先压缩空白，再按词从末尾删减，让剩余内容和 placeholder 一起放进宽度。正式 Python 3.15.0 的底层截断也会整块移除放不下的片段。单个长词可能最终只留下占位文本；虽然这种表现已有问题记录，不能把期望的另一种结果写成现有接口保证。

前缀预览可以定义独立规则

对于已确认为普通文本、按 Python 字符数限制的预览，可以明确留下前缀，再附后缀：

def prefix_preview(text: str, width: int, suffix: str = "...") -> str:
    if width < len(suffix):
        raise ValueError("width 不足以容纳后缀")
    if len(text) <= width:
        return text
    return text[:width - len(suffix)] + suffix

这段示例保留原文本的空白，不做 shorten() 那样的空白压缩。短文本直接返回原文；超长文本的总字符数不超过 width。width 与 suffix 是应用已经校验过的配置，不能用这段逻辑截断认证令牌、数据库键或其他必须完整传递的数据。

若业务要求按完整单词显示摘要，仍可继续使用 shorten，并接受长词可能无法保留的结果，或设计明确的长词降级策略。不能把两套契约混用，看到一次空预览就全局替换所有摘要处理。

字符数不等于终端显示列数

Python 字符串切片按码点进行，不是按 UTF-8 字节，也不保证一个用户看到的组合字符不会被截开。中文、组合音标、表情和终端控制序列还涉及显示宽度或字素簇；需要按屏幕列数对齐时，应采用能处理这些条件的显示层，不能只改 width。

同样，不要把 break_long_words=True 当作“最后一行一定保留部分长词”的承诺。它影响换行处理，但 truncate 阶段仍有自己的占位符放置逻辑。全局替换 placeholder 或给字符串塞空格，也会改变输出内容和后续搜索匹配。

复核应覆盖短文本、恰好达到宽度、长单词、带空格的句子及应用真实字符集，并确认完整原值仍保留在原数据位置。预览变短只属于展示行为，不应反向覆盖业务字段。