NSAttributeString使用介绍（含常用Attribute键值对照表）

一、NSAttributeString核心概念解析

NSAttributeString是iOS/macOS开发中用于处理富文本的核心类，它通过为字符串的不同片段附加属性（如字体、颜色、下划线等），实现文本样式的动态控制。相较于普通NSString，NSAttributeString的优势在于：

1. 局部样式控制：可对同一字符串的不同区间设置差异化样式
2. 性能优化：避免频繁创建多个UILabel实现复杂排版
3. 功能扩展：支持文本附件、阴影、删除线等高级特性

典型应用场景包括：

• 聊天应用中的@提及高亮
• 新闻客户端的标题加粗
• 电商APP的价格删除线效果
• 文档编辑器的字体设置

二、基础使用方法详解

1. 创建NSAttributeString对象

// 从字符串创建
let attributedString = NSAttributedString(
    string: "Hello, World!",
    attributes: [.font: UIFont.systemFont(ofSize: 16)]
)
// 从HTML创建（需处理兼容性）
if let htmlData = "<b>Bold</b> Text".data(using: .utf8) {
    do {
        let options: [NSAttributedString.DocumentReadingOptionKey: Any] = [
            .documentType: NSAttributedString.DocumentType.html
        ]
        let htmlString = try NSAttributedString(
            data: htmlData,
            options: options,
            documentAttributes: nil
        )
    } catch {
        print("HTML解析错误: \(error)")
    }
}

2. 属性设置方法对比

方法	适用场景	性能影响
init(string)	全局统一样式	最低
addAttributes	批量修改属性	中等
addAttributerange:	单个属性修改	最低
mutableString.replaceCharacters(in)	内容修改	较高

三、常用Attribute键值对照表

1. 文本外观属性

键名	值类型	示例效果
.font	UIFont	UIFont.boldSystemFont(ofSize: 18)
.foregroundColor	UIColor	.red 或 UIColor(red:0.5, green:0.5, blue:1.0, alpha:1.0)
.backgroundColor	UIColor	文字背景色设置
.strokeWidth	NSNumber	正值描边，负值填充描边
.strokeColor	UIColor	描边颜色设置

2. 段落样式属性

键名	值类型	示例效果
.paragraphStyle	NSParagraphStyle	行间距、对齐方式等
.kern	NSNumber	字间距调整（单位：点）
.ligature	NSNumber	连字设置（0禁用，1启用）

3. 特殊效果属性

键名	值类型	示例效果
.underlineStyle	NSUnderlineStyle	单线/双线/删除线
.obliqueness	NSNumber	文字倾斜度（0.5为45度）
.expansion	NSNumber	文字水平缩放（1.0为正常）

4. 高级功能属性

键名	值类型	示例效果
.attachment	NSTextAttachment	嵌入图片/附件
.baselineOffset	NSNumber	基线偏移量
.writingDirection	NSArray	文字方向控制

四、进阶应用技巧

1. 动态文本高亮实现

let fullText = "用户@张三 提到了您"
let attributedText = NSMutableAttributedString(string: fullText)
let mentionRange = (fullText as NSString).range(of: "@张三")
attributedText.addAttributes([
    .foregroundColor: UIColor.systemBlue,
    .font: UIFont.boldSystemFont(ofSize: 16)
], range: mentionRange)

2. 复杂排版实现

let paragraphStyle = NSMutableParagraphStyle()
paragraphStyle.lineSpacing = 8
paragraphStyle.alignment = .center
let complexText = NSMutableAttributedString(
    string: "多行文本排版示例\n第二行内容",
    attributes: [
        .paragraphStyle: paragraphStyle,
        .font: UIFont.systemFont(ofSize: 14)
    ]
)

3. 性能优化建议

1. 复用属性字典：避免频繁创建相同属性字典
2. 批量操作：使用beginEditing()/endEditing()包裹批量修改
3. 范围计算优化：使用NSString.range(of)替代循环查找
4. 内存管理：及时释放不再使用的NSAttributedString对象

五、常见问题解决方案

1. 属性不生效问题排查

1. 检查range参数是否有效
2. 确认属性键名拼写正确
3. 验证属性值类型是否匹配
4. 检查是否在正确的线程操作

2. 特殊字符处理技巧

// 处理表情符号等特殊字符
let text = "😊 特殊字符测试"
let attributedText = NSMutableAttributedString(string: text)
// 获取准确字符范围（考虑组合字符）
let fullRange = NSRange(location: 0, length: text.utf16.count)
attributedText.addAttribute(.font, value: UIFont.systemFont(ofSize: 20), range: fullRange)

3. 跨平台兼容性处理

• iOS/macOS差异：注意NSAttributedString.DocumentType的枚举值差异
• 字体回退机制：设置.font属性时考虑备用字体
• 颜色空间转换：确保UIColor使用正确的颜色空间

六、最佳实践总结

1. 分层设计：将基础样式与动态样式分离管理
2. 样式复用：建立常用样式字典库
3. 异步处理：复杂排版操作放在后台线程
4. 缓存机制：对重复使用的富文本进行缓存
5. 测试验证：在不同设备尺寸上测试显示效果

通过系统掌握NSAttributeString的核心属性和使用技巧，开发者可以高效实现各种复杂的文本展示需求，同时保持代码的可维护性和性能。建议结合实际项目需求，逐步构建自己的富文本处理工具库。