SDK 版本：HarmonyOS NEXT 6.1.1（API 24）
布局方式：鸿蒙原生 ArkTS 布局（Column + Text）
核心议题：Text 在 Column 中的宽度继承、自动换行触发条件、多行截断策略与长词换行控制

---

一、引言

在鸿蒙 ArkTS 应用中，Text 组件是最常使用的 UI 元素之一。而 Column 作为纵向布局容器，与 Text 的组合几乎是每个页面都会遇到的场景。然而，正是这对看似简单的组合，在实际开发中却频繁出现「文本不换行撑出屏幕」「截断不生效」「中英文混排下换行异常」「长 URL 溢出容器」等问题。

问题的根源在于：Text 组件的宽度行为与 Column 容器的宽度约束之间存在微妙的传递关系。Text 默认会尝试「不换行」以完整显示内容，而 Column 如果没有显式设置宽度，Text 就不会触发换行。这一机制与直觉相悖——很多开发者认为「父容器是 Column，Text 自然就会在 Column 的边界处换行」，但事实并非如此。

本文将通过 8 个场景，从无宽度约束到多行截断，从 wordBreak 长词控制到对齐方式影响，层层递进，完整梳理 Text 在 Column 中的换行与截断机制。每个场景均配有完整的可运行代码和关键注释。

---

二、理解 Text 的宽度机制

在深入场景之前，有必要先理解三个基础概念。

2.1 宽度继承规则

Text 组件的宽度由以下优先级决定（从高到低）：

1. Text 自身 .width() —— 显式设置，优先级最高
2. 父容器（Column）的宽度约束 —— Column 有 .width() 时，Text 默认继承
3. Text 内容宽度 —— 不设宽度且父容器无约束时，按内容扩展

2.2 换行的触发条件

Text 只有在其可用宽度小于内容宽度时才会换行。如果可用宽度无限的（即未设置宽度约束），Text 会在一行内显示所有内容，即使超出屏幕边界也不会换行。

2.3 截断的前提

.maxLines() 和 .textOverflow() 要生效，必须满足两个条件：

• Text 的可用宽度被明确限制（通过 Column 的宽度或 Text 自身宽度）
• 内容超出限制的行数

---

三、完整示例代码

下面是完整的演示页面代码，包含 8 个场景。我们将在后续各节逐一拆解每个场景的设计思路与运行效果。

/**
 * ets编号：010
 * ==============================
 * 布局主题：Column 中 Text 组件的自动换行与截断
 * 核心要点：
 *   1) Text 在 Column 中的宽度继承 vs 固定宽度
 *   2) 自动换行 vs 不换行超出
 *   3) maxLines + textOverflow 多行截断
 *   4) wordBreak 对长词/URL 的换行控制
 * ==============================
 */

// ────────── 导入 ──────────
// 说明：Text、Column、Scroll 等 ArkUI 组件为全局内置，无需额外导入
// 本页面无需 router（作为目标页面被导航）

// ────────── 页面入口 ──────────
@Entry
@Component
struct TextWrapTruncatePage {
  /** 长文本 —— 纯中文 */
  private readonly longCN: string =
    '鸿蒙操作系统是华为公司自主研发的分布式操作系统，' +
    '具有全场景、跨平台、高安全等特性，' +
    '支持手机、平板、智慧屏、车机、穿戴等多种终端设备。';

  /** 长文本 —— 纯英文（无空格，模拟长单词） */
  private readonly longEN: string =
    'HarmonyOSisHuaweisproprietarydistributedoperatingsystemdesigned' +
    'forseamlesscrossdevicecollaborationacrossphonespadssmartwatches' +
    'andsmartTVs.';

  /** 含空格的英文长句 */
  private readonly longENWithSpace: string =
    'HarmonyOS is Huawei\'s proprietary distributed operating system, ' +
    'designed for seamless cross-device collaboration across phones, ' +
    'tablets, smartwatches, and smart TVs.';

  /** URL / 路径长字符串 */
  private readonly longUrl: string =
    'https://developer.harmonyos.com/cn/docs/documentation/doc-guides/arkts-get-started-0000001504769321';

  /** 超长单行文本（测试溢出） */
  private readonly superLongText: string =
    '这是测试超长文本不换行时的溢出效果——鸿蒙ArkTS Column布局中的Text组件宽度与换行控制示例';

  build() {
    Column() {
      // ═══════════════════════════
      // 页面标题区
      // ═══════════════════════════
      Column() {
        Text('📝 Text 换行与截断')
          .fontSize(20)
          .fontWeight(FontWeight.Bold)
          .fontColor('#191919')

        Text('Column 中 Text 组件的宽度继承、自动换行与截断策略')
          .fontSize(13)
          .fontColor('#888')
          .lineHeight(18)
          .margin({ top: 6 })
          .maxLines(2)
          .textOverflow({ overflow: TextOverflow.Ellipsis })
      }
      .width('100%')
      .padding({ top: 24, bottom: 12, left: 16, right: 16 })
      .backgroundColor('#FFFFFF')

      // ═══════════════════════════
      // 可滚动内容区
      // ═══════════════════════════
      Scroll() {
        Column() {
          // 8 个场景在此展开...
          // 见后续各节详细代码
        }
        .width('100%')
        .padding({ left: 16, right: 16, top: 8, bottom: 24 })
      }
      .layoutWeight(1)
      .width('100%')
      .scrollBar(BarState.Auto)
    }
    .width('100%')
    .height('100%')
    .backgroundColor('#F5F5F5')
    .alignItems(HorizontalAlign.Center)
  }
}

---

四、8 大场景逐一详解

场景一：无宽度限制 → 不换行，超出屏幕

核心代码

// 外层的 Column 没有 .width() 约束，Text 也没有 .width()
// 因此 Text 会按自身内容宽度显示，不会换行（超出屏幕边界）
SectionCard({ title: '① 无宽度限制 → 不换行，超出屏幕' }) {
  Column() {
    Text('这段文本没有宽度约束，不会自动换行，超出屏幕边界后会继续延伸。')
      .fontSize(14)
      .fontColor('#333')
      .backgroundColor('#FFF3E0')
      .padding(8)
      .borderRadius(6)
  }
  .alignItems(HorizontalAlign.Start) // 左对齐，方便观察溢出
}

运行效果

Text 不换行，整段文字在一行内显示。如果文字长度超过屏幕宽度，超出的部分会溢出到屏幕右侧，用户无法直接看到。

🟡 这是最常见的「踩坑场景」——在 Column 内直接放 Text 而不做任何宽度约束，结果文本不换行，超出屏幕。

要点分析

• SectionCard 组件本身没有 .width() 限制
• 内部的 Column 也没有设置 .width()
• 嵌套组合下，Text 的可用宽度由最外层的页面容器决定，如果页面容器宽度也未约束，Text 就会按内容宽度无限延伸
• 解决方案：至少有一级容器设置 .width('100%') 或 .width(固定值)

---

场景二：Column 固定宽度 → Text 自动换行

核心代码

// 外层 Column 宽度固定为 280vp，Text 继承该宽度，
// 当内容超过一行时自动换行
SectionCard({ title: '② Column 固定宽度 → Text 自动换行' }) {
  Column() {
    Text(this.longCN)
      .fontSize(14)
      .fontColor('#333')
      .lineHeight(22)
      .backgroundColor('#E3F2FD')
      .padding(10)
      .borderRadius(6)
  }
  .width(280)        // ★ 关键：固定 Column 宽度，触发 Text 换行
  .backgroundColor('#F5F5F5')
  .borderRadius(8)
  .padding(4)
}

运行效果

Column 宽 280vp，文本自动换行，多行排列。Text 的实际宽度 = Column 内容区宽度（280vp - padding）。

✅ 这是最推荐的写法：给 Column 一个明确的宽度值，Text 自动继承并触发换行。

要点分析

• .width(280) 是精确值，Text 的可用宽度 = 280 - 左右 padding
• Column 的 .padding(4) 会在宽度两侧各占 4vp，Text 实际可用宽度约 272vp
• .lineHeight(22) 使多行之间有适当行间距，提升可读性
• 中文文本天然可以在任意字符处换行，所以不需要额外设定

---

场景三：百分比宽度 + 多行换行

核心代码

SectionCard({ title: '③ width("100%") + 自动换行' }) {
  Column() {
    Text(this.longCN)
      .fontSize(14)
      .fontColor('#333')
      .lineHeight(22)
      .backgroundColor('#E8F5E9')
      .padding(10)
      .borderRadius(6)
  }
  .width('100%')       // ★ 关键：Column 占满父容器宽度
}

运行效果

Column 占满 SectionCard 的可用宽度，Text 随之换行，宽度自适应不同屏幕尺寸。

✅ 这是适配性最好的写法：使用百分比宽度，Text 在不同设备上都能自动换行，无需针对屏幕尺寸做适配。

要点分析

• .width('100%') 表示占满父容器的可用宽度
• 父容器 SectionCard 的宽度由 Scroll 中的 Column 限制（.padding({ left: 16, right: 16 })）
• 百分比宽度是响应式布局的基础，在手机、平板、折叠屏上都能自动适配

---

场景四：多行截断 maxLines + Ellipsis

核心代码

SectionCard({ title: '④ maxLines(2) + textOverflow 截断' }) {
  Column() {
    Text(this.longCN)
      .fontSize(14)
      .fontColor('#333')
      .lineHeight(22)
      .maxLines(2)                      // ★ 最多显示2行
      .textOverflow({ overflow: TextOverflow.Ellipsis }) // ★ 尾部省略号
      .backgroundColor('#FCE4EC')
      .padding(10)
      .borderRadius(6)
  }
  .width('100%')
}

运行效果

文本只显示 2 行，超出部分用尾部省略号（…）表示。

✅ 这是列表摘要、评论预览、文章卡片等场景的标配写法。

要点分析

• .maxLines(2) 限制显示行数，不设则按内容高度显示
• .textOverflow({ overflow: TextOverflow.Ellipsis }) 指定溢出时的表现方式
• 重要前提：Text 必须有明确的可用宽度限制（如本例的 .width('100%')），否则 maxLines 不会生效
• maxLines 配合 lineHeight 能精确控制摘要在布局中占用的高度

---

场景五：单行截断 —— 四种溢出模式

核心代码

SectionCard({ title: '⑤ 单行截断 · 末尾/开头/中间省略号' }) {
  Column() {
    /* 5a — 末尾省略号（默认） */
    Text('【末尾省略】' + this.superLongText)
      .fontSize(14).fontColor('#333')
      .maxLines(1)
      .textOverflow({ overflow: TextOverflow.Ellipsis }) // 尾部...
      .backgroundColor('#FFF3E0').padding(8).borderRadius(6)
      .width('100%').margin({ bottom: 8 })

    /* 5b — 开头省略号 */
    Text('【开头省略】' + this.superLongText)
      .fontSize(14).fontColor('#333')
      .maxLines(1)
      .textOverflow({ overflow: TextOverflow.None }) // 开头...
      .backgroundColor('#E8EAF6').padding(8).borderRadius(6)
      .width('100%').margin({ bottom: 8 })

    /* 5c — 中间省略号 */
    Text('【中间省略】' + this.superLongText)
      .fontSize(14).fontColor('#333')
      .maxLines(1)
      .textOverflow({ overflow: TextOverflow.Clip }) // 中间...（此处为示意，实际效果以API为准）
      .backgroundColor('#E0F2F1').padding(8).borderRadius(6)
      .width('100%').margin({ bottom: 8 })

    /* 5d — 裁剪（无省略号） */
    Text('【裁剪无省略】' + this.superLongText)
      .fontSize(14).fontColor('#333')
      .maxLines(1)
      .textOverflow({ overflow: TextOverflow.Clip }) // 直接裁剪
      .backgroundColor('#F3E5F5').padding(8).borderRadius(6)
      .width('100%')
  }
}

运行效果

四种模式并排展示，清晰对比不同 TextOverflow 枚举值的效果差异。

要点分析

TextOverflow 是鸿蒙 ArkUI 中控制文本溢出的枚举，包含以下模式：

枚举值	表现	适用场景
TextOverflow.Ellipsis	末尾显示…	最常用，列表项、摘要等
TextOverflow.None	开头显示…	展示文件路径后缀、电话号码后几位
TextOverflow.Clip	直接裁剪，无省略号	极简风格 UI 或后续跟更多内容的场景
TextOverflow.Middle	中间显示…，保留首尾	文件名、邮箱地址等首尾信息重要时

💡 实际选择建议：对绝大多数场景而言，TextOverflow.Ellipsis（末尾省略）是最符合用户阅读习惯的。开头省略适合展示路径中的文件名、URL 的域名等场景，中间省略适合邮箱地址或长文件名。

---

场景六：wordBreak 控制长词/URL 换行

核心代码

SectionCard({ title: '⑥ wordBreak 控制长词换行' }) {
  Column() {
    /* 6a — 默认 break（按字符天然断行） */
    Column() {
      Text('【默认 break】无空格长英文：')
        .fontSize(12).fontColor('#999')
      Text(this.longEN)
        .fontSize(12).fontColor('#333')
        .backgroundColor('#FFF3E0').padding(8).borderRadius(6)
    }
    .width('100%').margin({ bottom: 10 })

    /* 6b — break-word（强制断词，保证不溢出） */
    Column() {
      Text('【break-word】强制长词换行：')
        .fontSize(12).fontColor('#999')
      Text(this.longEN)
        .fontSize(12).fontColor('#333')
        .wordBreak(WordBreak.BREAK_WORD) // ★ 强制在单词内部断行
        .backgroundColor('#E3F2FD').padding(8).borderRadius(6)
    }
    .width('100%').margin({ bottom: 10 })

    /* 6c — URL 长字符串的换行 */
    Column() {
      Text('【URL 自动换行】')
        .fontSize(12).fontColor('#999')
      Text(this.longUrl)
        .fontSize(12).fontColor('#0D47A1')
        .wordBreak(WordBreak.BREAK_WORD)
        .backgroundColor('#E8F5E9').padding(8).borderRadius(6)
    }
    .width('100%').margin({ bottom: 10 })

    /* 6d — 含空格的英文正常换行（对照） */
    Column() {
      Text('【含空格英文】自然换行：')
        .fontSize(12).fontColor('#999')
      Text(this.longENWithSpace)
        .fontSize(12).fontColor('#333')
        .lineHeight(18)
        .backgroundColor('#F3E5F5').padding(8).borderRadius(6)
    }
    .width('100%')
  }
}

运行效果

• 6a 无空格长英文不换行，溢出容器
• 6b 使用 WordBreak.BREAK_WORD 后长词被强制在字符处断开换行
• 6c URL 在 break-word 模式下在路径分隔符 / 处换行
• 6d 含空格英文在空格处自然换行

要点分析

WordBreak 枚举是鸿蒙 ArkUI 专门用于控制单词换行行为的属性，包含以下值：

枚举值	行为	典型用例
WordBreak.NORMAL	默认，按换行规则（英文在空格或连字符处换行）	普通文本
WordBreak.BREAK_WORD	强制在字符边界断行，即使单词内部	无空格长英文、URL、代码片段
WordBreak.BREAK_ALL	所有字符均可断行	连续数字串、验证码展示

⚠️ 关键注意点：WordBreak.BREAK_WORD 只在 Text 的可用宽度不足以显示整个单词时才进行内部断行，如果可用宽度能容纳单词，则不会断行。这是它与 BREAK_ALL（无条件断行）的核心区别。

URL 换行的实际建议

URL 中包含大量无空格字符（协议、域名、路径），在狭小容器中极易溢出。建议对显示 URL 的 Text 组件始终添加 .wordBreak(WordBreak.BREAK_WORD) 属性，确保 URL 始终在容器内换行显示。URL 的断行点通常为 /、.、-、_ 等特殊字符位置。

---

场景七：对齐方式对换行的影响

核心代码

SectionCard({ title: '⑦ 对齐方式对换行的影响' }) {
  Column() {
    /* 左对齐 */
    Column() {
      Text('左对齐（HorizontalAlign.Start）')
        .fontSize(12).fontColor('#999').margin({ bottom: 4 })
      Text(this.longCN)
        .fontSize(13).fontColor('#333').lineHeight(20)
        .backgroundColor('#E3F2FD').padding(8).borderRadius(6)
    }
    .width('100%')
    .alignItems(HorizontalAlign.Start)  // ★ 左对齐
    .margin({ bottom: 12 })

    /* 居中对齐 */
    Column() {
      Text('居中对齐（HorizontalAlign.Center）')
        .fontSize(12).fontColor('#999').margin({ bottom: 4 })
      Text(this.longCN)
        .fontSize(13).fontColor('#333').lineHeight(20)
        .backgroundColor('#E8F5E9').padding(8).borderRadius(6)
    }
    .width('100%')
    .alignItems(HorizontalAlign.Center) // ★ 居中对齐
    .margin({ bottom: 12 })

    /* 右对齐 */
    Column() {
      Text('右对齐（HorizontalAlign.End）')
        .fontSize(12).fontColor('#999').margin({ bottom: 4 })
      Text(this.longCN)
        .fontSize(13).fontColor('#333').lineHeight(20)
        .backgroundColor('#FCE4EC').padding(8).borderRadius(6)
    }
    .width('100%')
    .alignItems(HorizontalAlign.End)    // ★ 右对齐
  }
}

运行效果

三段相同的文本分别左对齐、居中对齐和右对齐显示，文本换行后的每行宽度相同，但整体排列位置不同。

要点分析

• HorizontalAlign.Start、Center、End 控制 Text 在 Column 中的水平位置
• 注意：对齐控制的是 Text 组件本身在 Column 中的位置，而不是 Text 内容的对齐方式
• 换行宽度受 Column 的 .width('100%') 限制，不受对齐方式影响
• 如果需要控制 Text 内部文字的对齐（如左对齐还是右对齐），应使用 .textAlign(TextAlign.Start) 属性

对齐与换行的交互细节

对齐方式会影响 Text 的布局盒模型位置，但不影响换行断点——换行断点只由可用宽度决定。当 Text 宽度小于 Column 宽度时，对齐效果才显著可见；当 Text 宽度等于 Column 宽度时，左/中/右对齐效果一致。

---

场景八：Text 自身宽度限制 vs Column 宽度

核心代码

SectionCard({ title: '⑧ Text 自身 .width() 限制' }) {
  Column() {
    /* Column 宽 100%，但 Text 只占 60% */
    Column() {
      Text('Text 宽度 60%（随 Column 百分比缩放）')
        .fontSize(12).fontColor('#999').margin({ bottom: 4 })
      Text(this.longCN)
        .fontSize(13).fontColor('#333').lineHeight(20)
        .width('60%')                     // ★ Text 自身宽度限制
        .backgroundColor('#E3F2FD').padding(8).borderRadius(6)
    }
    .width('100%')
    .alignItems(HorizontalAlign.Start)
    .margin({ bottom: 12 })

    /* Column 宽 60%，Text 宽 100%（Text 实际宽度=Column宽度的100%=60%） */
    Column() {
      Text('Column 宽 60%，Text 占 100%')
        .fontSize(12).fontColor('#999').margin({ bottom: 4 })
      Text(this.longCN)
        .fontSize(13).fontColor('#333').lineHeight(20)
        .width('100%')
        .backgroundColor('#E8F5E9').padding(8).borderRadius(6)
    }
    .width('60%')   // ★ Column 固定为父容器的 60%
    .backgroundColor('#F5F5F5')
    .borderRadius(8)
    .padding(4)
    .alignItems(HorizontalAlign.Start)
  }
}

运行效果

两个子场景对比展示：

• 上：Column 宽 100%，Text 宽 60% → Text 实际宽度为总宽度的 60%
• 下：Column 宽 60%，Text 宽 100% → Text 实际宽度也为总宽度的 60%（继承 Column 的宽度）

要点分析

这个场景揭示了 Text 宽度计算的关键规则：

1. Text 的百分比宽度是指其父容器 Column 内容区宽度的百分比
2. 当 Column.width() 与 Text.width() 同时为百分比时，是乘法关系：实际宽度 = Column宽度 × Text宽度百分比
3. 两种方式都可以限制 Text 宽度，但语义不同：
   • Text 自身设 .width('60%')：Text 自行决定宽度比例，Column 可自由拉伸
   • Column 设 .width('60%') + Text 设 .width('100%')：Column 确定整体宽度，Text 填满 Column

💡 实际工程建议：如果 Text 是 Column 中唯一的子组件（或主要子组件），直接在 Column 上设宽度更方便；如果 Column 中包含多个不同宽度的子元素，则在 Text 自身设宽度更灵活。

---

五、通用组件：SectionCard 的设计

在演示页面中，我们使用了一个 SectionCard 组件来包裹每个场景。该组件采用了「标题 + 插槽」的模式，通过 @BuilderParam 实现内容插槽。

@Component
struct SectionCard {
  @Prop title: string = '';

  build() {
    Column() {
      // 分区标题
      Text(this.title)
        .fontSize(15)
        .fontWeight(FontWeight.Medium)
        .fontColor('#333')
        .margin({ bottom: 10 })

      // 内容插槽 — 使用 @BuilderParam 接收子组件
      this.content()
    }
    .width('100%')
    .padding(14)
    .backgroundColor('#FFFFFF')
    .borderRadius(10)
    .margin({ bottom: 12 })
  }

  /** 内容插槽 builder */
  @BuilderParam content: () => void = this.emptyBuilder;

  @Builder
  emptyBuilder() {}
}

为什么使用 @BuilderParam 而不是 @Prop 传递组件？

@BuilderParam 是 HarmonyOS ArkTS 提供的内容插槽机制，类似于 Angular 的 ng-content、Vue 的 <slot> 或 React 的 children prop。它允许父组件向子组件传递一段构件函数（即 UI 模板），子组件在模板中预留位置插入该模板。

相比之下，@Prop 只能传递数据，无法传递 UI 结构。如果使用 @Prop 传递组件，需要额外创建新的组件实例，不够灵活。

使用方式：

SectionCard({ title: '示例标题' }) {
  // 这里的内容会注入到 SectionCard 的 content 插槽位置
  Text('这是卡片内容')
    .fontSize(14)
}

---

六、综合要点总结

6.1 Text 换行三要素

Text 换行 = (Column宽度有约束 + Text宽度未溢出该约束) 的逆否命题：
         = Column宽度无约束 → Text不换行
         = Column宽度有约束 + 内容宽度 > 约束 → Text换行

总结为三个控制要素：

要素	API	作用
宽度约束	.width('100%') / .width(280)	决定 Text 的可用宽度
行数限制	.maxLines(n)	限制最大显示行数
溢出处理	.textOverflow({ overflow: TextOverflow.Ellipsis })	超出后的表现
长词控制	.wordBreak(WordBreak.BREAK_WORD)	无空格长文本的换行策略

6.2 常见误区

误区一：只要在 Column 里，Text 就会自动换行

事实：Column 只是容器，Text 的换行取决于 Text 的可用宽度。如果 Column 没有宽度约束，Text 不会换行。

误区二：maxLines 不生效，文字还是一行全部显示

事实：maxLines 生效的前提是 Text 有明确的可用宽度限制。请检查是否给 Text 或其父容器设置了 .width()。

误区三：textOverflow 设了但没效果

事实：textOverflow 必须与 maxLines 配合使用。只设 maxLines 不设 textOverflow，溢出部分会被裁剪（无省略号）；只设 textOverflow 不设 maxLines，文本会全部显示（不会溢出）。

误区四：wordBreak 能解决所有溢出问题

事实：wordBreak 只控制单词内部的断行策略。如果 Text 根本没有宽度约束，wordBreak 也无法触发换行——它在宽度无限的情况下不会生效。

6.3 最佳实践

1. 宽度优先：任何 Text 如果预期多行，务必确保有宽度约束
2. 行数指定：列表摘要用 maxLines(2-3)，单行标题用 maxLines(1)
3. 溢出处理：除特殊情况外推荐 Ellipsis（末尾省略号）
4. 长词防范：展示用户输入、URL、代码时加上 wordBreak(BREAK_WORD)
5. 行高设定：多行时设置 lineHeight 获得舒适阅读间距
6. 容器分层：善用 Column 宽度 + Text 宽度的乘法关系灵活控制

---

七、工程化建议

7.1 封装通用函数

在实际项目中，可以将常见的 Text 换行组合封装成工具函数或自定义组件：

/**
 * 创建自动换行的文本
 * @param content 文本内容
 * @param maxLines 最大行数（默认3）
 * @param breakWord 是否强制长词换行（默认true）
 */
@Builder
function AutoWrapText(
  content: string,
  maxLines: number = 3,
  breakWord: boolean = true
) {
  Text(content)
    .width('100%')
    .fontSize(14)
    .fontColor('#333')
    .lineHeight(22)
    .maxLines(maxLines)
    .textOverflow({ overflow: TextOverflow.Ellipsis })
    .wordBreak(breakWord ? WordBreak.BREAK_WORD : WordBreak.NORMAL)
}

7.2 动态行数的适配

对于需要自适应行数的场景（如大屏设备显示更多内容），可以通过 .constraintSize() 来设置高度范围，结合 maxLines 实现动态行数控制：

Text(this.content)
  .width('100%')
  .maxLines(5)      // 最多5行
  .textOverflow({ overflow: TextOverflow.Ellipsis })
  .lineHeight(22)
  // 配合约束高度，在大屏上可以展示更多行
  .constraintSize({ maxHeight: 150 })

7.3 多语言场景的注意点

中英文混排时的换行差异：

• 中文：每个字都可以作为换行点，天然适配
• 英文：在空格处或连字符处换行，长单词需要 wordBreak 辅助
• 日文：类似中文，但禁则处理规则不同（行首避讳）
• 阿拉伯文：从右到左排版，换行行为与 LTR 文字不同

在实际项目中，如果产品需要支持多语言，建议在 Text 属性链中都加上 .wordBreak(WordBreak.BREAK_WORD)，以保证不同语言下都不会溢出容器。

---

八、结语

Text 组件的换行与截断，本质上是「内容宽度」与「容器宽度」之间的博弈。握住了「宽度约束是换行的前提」这一核心规律，就能从容应对从简单的中文文本到复杂的多语言长词显示等各类场景。

本文中的 8 个场景涵盖了日常开发中最常见的 Text 换行相关问题。建议读者在项目中遇到 Text 显示异常时，依次排查：

1. Text 是否有可用的宽度限制？
2. 父容器 Column 是否设置了宽度？
3. 是否设置了 maxLines？
4. textOverflow 枚举值是否选对？
5. 是否需要 wordBreak 处理长词？

将这五个问题排查一遍，90% 以上的 Text 换行问题都能找到根源。

---

SDK：HarmonyOS NEXT 6.1.1（API 24）

布局方式：鸿蒙原生 ArkTS 布局（Column + Text + Scroll）