Text组件默认wrap="none"，即不换行；需显式设wrap="word"（单词边界断行）或wrap="char"（字符级断行），且换行效果依赖父容器实际像素宽度而非width参数。
Text 组件默认 wrap="none"，不是 bug 是设计
敲回车没反应、文字挤成一长条、滚动条拉到底才看到换行——这不是 Text 坏了，是它压根没开换行。Tkinter 的 Text 默认用 wrap="none"，即完全不折行，哪怕窗口只剩 10 像素宽，它也坚持把所有内容塞进一行里。
实操建议：
-
wrap="word"是最常用选择：在单词边界处断行，中英文都自然； -
wrap="char"可以用，但会把英文单词从中间劈开（比如 “hello” 拆成 “hel” + “lo”）； -
wrap="none"不是不能用，而是适合日志查看、代码编辑等需要横向滚动的场景； -
width参数只影响初始列数，和是否换行无关；真正起作用的是wrap+ 父容器实际像素宽度。
ScrolledText 也要单独设 wrap，别指望继承
用 ScrolledText 时，很多人以为设置了父容器或主窗口的 wrap 就够了，结果发现滚动条拉到最右才看到换行效果——因为 ScrolledText 是独立组件，它的 wrap 必须显式传入。
常见错误现象：
立即学习“Python免费学习笔记（深入）”；
- 文本看起来“卡在一行”，滚动条水平方向可拖动；
- 调用
.pack(fill="both", expand=True)后仍不随窗口缩放换行；
正确做法：
Work Productivity Word Mail Workflow Helper
下载
构建并排查Microsoft Word邮件合并及DOCX模板工作流，使用合并域、内容控件、文档属性、重复区块、数据等
- 初始化时必须写
ScrolledText(root, wrap="word")； - 如果后续动态修改，用
widget.configure(wrap="word")； - 别漏掉
state="disabled"（当用作只读多行标签时），否则用户能误删内容。
中文输入异常？大概率是字体惹的祸
即使设了 wrap="word"，中文仍显示错位、换行点偏移、光标跳动——问题常出在非等宽字体上。Tkinter 的换行逻辑依赖字符宽度估算，而多数中文字体（如微软雅黑、宋体）不是严格等宽，导致位置计算偏差。
实操建议：
- 优先用等宽中文字体，例如
"YaHei Consolas Hybrid"、"Source Code Pro"或系统自带的"SimSun-ExtB"； - 设置方式：
font=("Source Code Pro", 12)； - 避免用纯图形化字体（如 "HarmonyOS Sans"）做
Text主体，它们对 Tkinter 渲染支持不稳定； - 测试时用固定长度中文句（如 20 个“啊”）观察换行是否整齐，比用混合中英文更易暴露问题。
insert() 和 get() 的索引写法容易错
Text 的索引不是整数，是字符串格式的 "行.列"，比如 "1.0" 表示第 1 行第 0 列（首字符位置），"end" 表示末尾。写错索引会导致插入失败、内容覆盖或 get() 返回空字符串。
关键细节：
- 行号从
1开始，列号从0开始； -
"end"插入时等价于"insert"光标位置，但"end-1c"才是去除末尾换行符的安全取值； - 用
text.get("1.0", "end-1c")获取全部内容，别漏掉-1c，否则末尾会多一个换行； - 批量插入多行文本时，用
\n分隔即可，Text会按wrap规则渲染，不需要手动切分每行再循环insert。
最常被忽略的一点：换行行为依赖父容器的实际像素尺寸，而不是 width 或 height 的字符数设定。如果你用了 pack 或 grid 但没给父容器留足空间（比如父 Frame 没设 fill="both"），wrap="word" 也会失效——它没地方可换。
