YYText 源码解析：从架构到实现的深度探索

一、YYText 概述与核心定位

YYText 是专为 iOS 平台设计的高性能富文本处理库，其核心价值在于解决原生 UITextView/UILabel 在动态样式、异步渲染、复杂布局等场景下的性能瓶颈。相较于 CoreText 的底层复杂性和 NSAttributedString 的功能局限，YYText 通过分层架构设计实现了三大突破：

1. 动态属性系统：支持运行时修改文本属性（如颜色、字体、阴影等）而不触发重排
2. 异步渲染管道：将文本测量与绘制分离，利用 GCD 实现多线程优化
3. 布局引擎扩展：提供垂直布局、图文混排、 exclusion paths 等高级布局能力

在美团、抖音等千万级 DAU 应用中，YYText 已被验证可显著降低 CPU 占用率（实测降低 40%-60%），特别适合需要高频更新文本内容的社交、资讯类场景。

二、架构设计与核心模块

2.1 分层架构解析

YYText 采用经典的 MVC 变体架构：

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  Model层    │←──→│ Controller层 │←──→│  View层     │
│ (YYTextRun) │    │ (YYTextLayout)│    │ (YYLabel)   │
└─────────────┘    └─────────────┘    └─────────────┘

• Model层：YYTextRun 作为最小渲染单元，封装字符属性（CTRunRef）与几何信息
• Controller层：YYTextLayout 负责整体布局计算，管理文本行（YYTextLine）的生成与缓存
• View层：YYLabel 对接 UIKit，处理触摸事件与视图更新

这种设计使得文本属性修改仅需更新 Model 层，而无需触发完整重排，这是其高性能的关键。

2.2 异步渲染机制

YYText 的渲染流程分为三阶段：

1. 测量阶段（主线程）：

   - (CGSize)sizeThatFits:(CGSize)size {
       YYTextLayout *layout = [YYTextLayout layoutWithContainerSize:size text:self.attributedText];
       return layout.textBoundingSize;
   }

   通过 YYTextLayout 快速计算文本尺寸，避免阻塞 UI 渲染。

2. 布局阶段（全局队列）：

   // YYTextLayout.m 核心方法
   - (void)_updateLines {
       CTFramesetterRef framesetter = CTFramesetterCreateWithAttributedString(...);
       CGPathRef path = CGPathCreateWithRect(containerSize, NULL);
       CTFrameRef frame = CTFramesetterCreateFrame(...);
       // 解析 CTLine 并生成 YYTextLine 对象
   }

   利用 CoreText 的 CTFramesetter 进行异步布局计算，将结果缓存为 YYTextLine 数组。

3. 绘制阶段（主线程）：

   - (void)drawRect:(CGRect)rect {
       [self.layout drawInContext:UIGraphicsGetCurrentContext()];
   }

   通过 YYTextLayout 的 drawInContext: 方法完成最终绘制，支持部分重绘优化。

三、关键技术实现

3.1 动态属性系统

YYText 通过 YYTextHighlight、YYTextAttachment 等类实现动态样式：

// 创建高亮属性
YYTextHighlight *highlight = [YYTextHighlight new];
highlight.color = [UIColor redColor];
highlight.backgroundBorder = [YYTextBorder borderWithLineStyle:YYTextLineStyleSingle];
// 添加到富文本
NSMutableAttributedString *text = [[NSMutableAttributedString alloc] initWithString:@"Click me"];
[text yy_setTextHighlight:highlight range:NSMakeRange(0, text.length)];

其底层实现利用 NSTextAttachment 的子类化，通过 YYTextRunDelegate 动态调整字符尺寸，避免传统方式需要重新计算整个布局的问题。

3.2 高级布局引擎

YYText 的布局系统支持多种复杂场景：

• 垂直布局：通过 verticalForm 属性实现中文竖排

  layout.verticalForm = YES;
  layout.lineBreakMode = NSLineBreakByCharWrapping;

• 图文混排：继承自 NSTextAttachment 的 YYTextAttachment 支持自定义视图

  YYTextAttachment *attachment = [YYTextAttachment new];
  attachment.content = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"icon"]];
  attachment.bounds = CGRectMake(0, 0, 20, 20);

• Exclusion Paths：利用 CTFramePath 实现文本绕排

  UIBezierPath *path = [UIBezierPath bezierPathWithOvalInRect:CGRectMake(50, 50, 100, 100)];
  layout.exclusionPaths = @[path];

3.3 性能优化策略

1. 缓存机制：YYTextLayout 缓存布局结果，相同属性文本直接复用
2. 增量更新：通过 YYTextRun 的 dirty 标记实现局部重排
3. 内存管理：使用 NSMapTable 替代 NSDictionary 存储弱引用对象，避免循环引用

四、实践建议与避坑指南

4.1 最佳实践

1. 预计算布局：在 viewDidLayoutSubviews 中提前计算文本尺寸

   - (void)viewDidLayoutSubviews {
       self.layout = [YYTextLayout layoutWithContainerSize:self.bounds.size text:self.attributedText];
       [self setNeedsDisplay];
   }

2. 异步加载大文本：对于超过 1000 行的文本，使用 YYAsyncLayer 分解渲染任务
3. 样式复用：通过 YYTextEffectWindow 缓存常用高亮样式

4.2 常见问题解决方案

1. 性能下降：检查是否频繁调用 sizeThatFits:，应改用缓存的 textBoundingSize
2. 布局错乱：确保 containerSize 与视图 bounds 一致，避免自动布局冲突
3. 内存泄漏：注意 YYTextAttachment 持有的视图对象要及时释放

五、总结与展望

YYText 的源码实现展现了 iOS 富文本处理的最佳实践，其分层架构、异步渲染和动态属性系统为复杂文本场景提供了高效解决方案。对于开发者而言，掌握其核心设计思想（如增量更新、缓存策略）比单纯使用 API 更有价值。未来，随着 Metal 2 和 Core Animation 的演进，YYText 或将引入硬件加速的渲染路径，进一步提升性能上限。

建议开发者深入阅读 YYTextLayout.m 和 YYTextRun.m 的实现，这些文件集中体现了其架构设计的精妙之处。在实际项目中，可结合 YYWebImage 实现图文混排的异步加载，构建更完整的富文本解决方案。