siteline/swiftui-introspect

这是什么？

核心功能

• 01可访问众多 SwiftUI 控件底层的 UIKit 或 AppKit 视图。
• 02支持 iOS、tvOS、visionOS 和 macOS 平台。
• 03每个introspect目标需要显式指定系统版本，以保证可预测性。
• 04提供范围式版本条件，可覆盖未来的系统版本。
• 05支持自定义可 introspect 的视图类型，用于库未覆盖的元素。

适用场景

• 调整 SwiftUI List 或 ScrollView 的回弹行为和背景色。
• 在原生修饰符之外定制 TextField 或 SecureField 的外观。
• 设置 NavigationStack 或 NavigationView 的导航栏样式。
• 在 iOS 应用中保留原生 UIKit 视图的引用，以进行高级控制。

快速上手

1. 1

   将 SwiftUIIntrospect 包添加到 Swift Package Manager 依赖中

   .package(url: "https://github.com/siteline/swiftui-introspect", from: "27.0.0"),
2. 2

   将 SwiftUIIntrospect 产品添加到目标的依赖中

   .product(name: "SwiftUIIntrospect", package: "swiftui-introspect"),

使用前须知

• !由于底层 UIKit/AppKit 类型可能在主要系统版本之间变化，每个系统版本都需要显式开启支持（例如 .iOS(.v18)）。
• !仅支持 README 中列出的视图类型，许多 SwiftUI 视图（如 Text 和 Image）无法被内省。

收录于专题

标签

常见问题

swiftui-introspect 是什么？

一个 Swift 库，让 SwiftUI 视图能够访问底层的 UIKit 或 AppKit 视图并进行定制。 SwiftUI 没有暴露底层 UIKit 和 AppKit 组件的许多属性。SwiftUI Introspect 通过在视图前后插入不可见的标记视图，并在两者之间的视图层级中查找对应的 UIKit 或 AppKit 实例（如 UIScrollView、NSTextField），把原生视图交给闭包处理，从而修改 SwiftUI 本身不提供的属性。

swiftui-introspect 可以免费使用吗？用的什么许可证？

swiftui-introspect 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

swiftui-introspect 还在维护吗？

半年内有更新。swiftui-introspect 最近一次提交是在 2026年10月7日。

swiftui-introspect 适合用来做什么？

调整 SwiftUI List 或 ScrollView 的回弹行为和背景色。 在原生修饰符之外定制 TextField 或 SecureField 的外观。 设置 NavigationStack 或 NavigationView 的导航栏样式。 在 iOS 应用中保留原生 UIKit 视图的引用，以进行高级控制。

swiftui-introspect 怎么安装和运行？

将 SwiftUIIntrospect 包添加到 Swift Package Manager 依赖中: .package(url: "https://github.com/siteline/swiftui-introspect", from: "27.0.0"), 将 SwiftUIIntrospect 产品添加到目标的依赖中: .product(name: "SwiftUIIntrospect", package: "swiftui-introspect"),

在哪里获取 swiftui-introspect？

源代码和安装说明在 GitHub 上：https://github.com/siteline/swiftui-introspect