Android开发：如何禁用按字符换行，仅启用按单词换行？含自适应AppCompatTextView场景

安全阿岳

2026-8-19

Android文本换行配置：仅按单词换行实现方案

1. 普通TextView禁用字符换行，仅按单词换行

要让TextView只在单词边界换行、不拆分单个单词，可通过以下两种方式配置：

XML布局配置

在TextView标签中添加以下属性：

android:breakStrategy="high_quality"
android:hyphenationFrequency="none"

breakStrategy="high_quality"：启用高质量换行策略，优先在单词间隙换行，避免拆分单词
hyphenationFrequency="none"：完全禁用连字符拆分单词的功能

代码动态配置

如果需要在代码中动态设置：

// Kotlin示例
textView.breakStrategy = BreakStrategy.HIGH_QUALITY
textView.hyphenationFrequency = HyphenationFrequency.NONE

// Java示例
textView.setBreakStrategy(BreakStrategy.HIGH_QUALITY);
textView.setHyphenationFrequency(HyphenationFrequency.NONE);

2. 自适应大小AppCompatTextView仅按单词换行

使用AppCompatTextView并开启自动调整文本大小时，只需在自适应配置基础上，添加换行控制属性即可：

XML布局配置

<androidx.appcompat.widget.AppCompatTextView
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:autoSizeTextType="uniform"
    app:autoSizeMinTextSize="12sp"
    app:autoSizeMaxTextSize="24sp"
    app:autoSizeStepGranularity="2sp"
    android:breakStrategy="high_quality"
    android:hyphenationFrequency="none"
    android:text="你的长文本内容"/>

核心还是breakStrategy和hyphenationFrequency两个属性，自动调整大小的配置不会影响换行策略，只需确保这两个属性正确设置即可。