iOS 26 中 largeSubtitleTextAttributes 为什么不生效？

2026-11-04数据阿明

从复现现象看，还不能断定配置有误。主标题在展开和收起时能切换颜色，说明外观配置至少部分生效；副标题始终使用 subtitleTextAttributes，更像是当前运行环境中的大副标题样式没有按预期应用。不过，这些现象还不足以确认是否为已知系统缺陷，也无法确定哪些 iOS 26 版本受到影响。

在 UIKit 中，可以先使用你已经验证有效的 attributedSubtitle 和 largeAttributedSubtitle。SwiftUI 的 NavigationStack 则需要进一步检查外观状态，或通过 UIKit 桥接处理。

先排除导航栏外观状态的影响

原代码只设置了 standardAppearance。导航栏还有 scrollEdgeAppearance 等外观配置，不能只凭“大标题已经变绿”就判断所有状态都使用同一份配置。

可以先让标准状态和滚动边缘状态使用相同的 appearance，减少排查变量：

let appearance = UINavigationBarAppearance()

appearance.largeTitleTextAttributes = [
    .foregroundColor: UIColor.green
]
appearance.largeSubtitleTextAttributes = [
    .foregroundColor: UIColor.yellow
]
appearance.titleTextAttributes = [
    .foregroundColor: UIColor.blue
]
appearance.subtitleTextAttributes = [
    .foregroundColor: UIColor.red
]

let navAppearance = UINavigationBar.appearance()
navAppearance.standardAppearance = appearance
navAppearance.scrollEdgeAppearance = appearance

使用全局 appearance 配置时，建议在导航栏创建前完成设置，并重新创建页面验证。同时检查页面内是否有其他代码覆盖导航栏外观。

这一步是为了排查不同状态配置不一致的影响，不能保证修复 largeSubtitleTextAttributes 的问题。如果统一配置后副标题仍始终为红色，应继续排查副标题属性的实际应用行为。

UIKit：使用已经验证有效的属性化副标题

你提供的测试结果表明，在当前环境中分别设置 navigationItem.attributedSubtitle 和 navigationItem.largeAttributedSubtitle，副标题可以正确切换。可以在对应的 UIViewController 中这样设置：

navigationItem.attributedSubtitle = NSAttributedString(
    string: "Subtitle",
    attributes: [.foregroundColor: UIColor.red]
)

navigationItem.largeAttributedSubtitle = NSAttributedString(
    string: "Subtitle",
    attributes: [.foregroundColor: UIColor.yellow]
)

这两个属性将样式直接设置在当前 navigationItem 的副标题文本上。这种方式已在你的环境中验证有效，但不能据此判断 UINavigationBarAppearance 中对应属性的内部实现或失效原因。

SwiftUI：需要接触实际承载页面的 navigationItem

.navigationSubtitle(“Subtitle”) 没有直接提供设置上述两个属性化副标题的入口。如果要复用 UIKit 方案，需要通过 UIKit 桥接，取得实际承载页面的 UIViewController 并配置其 navigationItem。

需要注意控制器层级：嵌入 UIViewControllerRepresentable 后，它自己的 navigationItem 不一定就是屏幕上导航栏正在使用的那个。实现时要确认配置对象确实属于当前导航页面，并在页面更新时同步副标题内容。

如果暂时不想维护桥接代码，可以先让两种状态使用相同的副标题颜色。如果必须分别控制，也可以考虑自定义导航栏标题区域，但系统的大标题布局和滚动收起效果需要另行评估。

如何判断是否值得提交系统问题

建议保留最小复现，并记录具体的 iOS 26 系统版本、Xcode 版本，以及模拟器和真机上的表现。重点对比以下结果：

统一 standardAppearance 和 scrollEdgeAppearance 后，是否仍然复现。
SwiftUI 与纯 UIKit 页面是否表现一致。
largeSubtitleTextAttributes 是否失效，而 largeAttributedSubtitle 是否有效。

如果这些对照结果保持一致，就有较充分的复现材料向 Apple 提交反馈。现有信息支持“疑似系统样式应用异常”的判断，尚不足以给出官方缺陷结论或修复版本。