如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
Codex

Codex 使用场景

重构 SwiftUI 界面

使用 Codex 将过大的 SwiftUI 界面拆分为小型子视图,同时保持行为和布局不变。

难度 Advanced
时间跨度 1h

使用 Codex 和 Build iOS Apps 插件,将过长的 SwiftUI 视图按区域拆分为独立的子视图,把副作用移出 body,并让状态管理和 Observation 的使用更稳定。重构时优先采用 MV,避免引入不必要的视图模型。

最适合

  • 大型 SwiftUI 文件,其中一个界面的 `body` 混杂了布局、条件分支、异步任务和内联操作,导致代码难以审查
  • 需要保持外观和行为不变,同时提高内部代码可维护性的现有 iOS 功能
  • 使用 `some View` 计算属性构建局部视图、使用可选视图模型或状态传递复杂的界面,可通过明确定义子视图的输入和回调来简化实现

目录

    ← 所有使用场景

    重构 SwiftUI 界面

    使用 Codex 将过大的 SwiftUI 界面拆分为小型子视图,同时保持行为和布局不变。

    使用 Codex 和 Build iOS Apps 插件,将过长的 SwiftUI 视图按区域拆分为独立的子视图,把副作用移出 body,并让状态管理和 Observation 的使用更稳定。重构时优先采用 MV,避免引入不必要的视图模型。

    Advanced
    1h

    使用 Codex 和 Build iOS Apps 插件,将过长的 SwiftUI 视图按区域拆分为独立的子视图,把副作用移出 body,并让状态管理和 Observation 的使用更稳定。重构时优先采用 MV,避免引入不必要的视图模型。

    Advanced
    1h

    最适合

    • 大型 SwiftUI 文件,其中一个界面的 `body` 混杂了布局、条件分支、异步任务和内联操作,导致代码难以审查
    • 需要保持外观和行为不变,同时提高内部代码可维护性的现有 iOS 功能
    • 使用 `some View` 计算属性构建局部视图、使用可选视图模型或状态传递复杂的界面,可通过明确定义子视图的输入和回调来简化实现

    技能与插件

    • 在 Codex 修改大型 SwiftUI 界面时,使用 SwiftUI 视图重构技能提取职责明确的子视图,保持数据流稳定,简化 Observation 的用法,并保留界面的原有行为。
    技能 使用理由
    Build iOS Apps 在 Codex 修改大型 SwiftUI 界面时,使用 SwiftUI 视图重构技能提取职责明确的子视图,保持数据流稳定,简化 Observation 的用法,并保留界面的原有行为。

    起始提示词

    使用 Build iOS Apps 插件及其 SwiftUI 视图重构技能,整理 [NameOfScreen.swift] 的代码,保持界面的功能和外观不变。 约束条件: - 除非发现必须单独说明的缺陷,否则请保持行为、布局、导航和业务逻辑不变。 - 默认采用 MV 而非 MVVM。在引入新的视图模型之前,优先使用 `@State`、`@Environment`、`@Query`、`.task`、`.task(id:)` 和 `onChange`。只有当该功能确实需要视图模型时才保留它。 - 调整视图代码的顺序,从上到下依次排列存储属性、计算得出的状态、`init`、`body`、视图辅助代码和辅助方法,方便浏览。 - 将职责明确的界面区域提取为独立的 `View` 类型,通过少量明确的输入参数、`@Binding` 和回调传递数据与操作。不要把一个庞大的 `body` 拆成多个同样庞大的 `some View` 计算属性。 - 将较复杂的按钮操作和副作用从 `body` 移到简短的方法中,并将业务逻辑移到服务或模型中。 - 保持根视图树稳定。如果在局部使用条件视图或修饰符就能满足需求,请避免用顶层 `if/else` 分支在完全不同的界面之间切换。 - 重构时修正 Observation 模型的所有权问题。在 iOS 17 及更高版本上,使用 `@State` 持有根 `@Observable` 模型。除非 UI 确实需要这样表示状态,否则请避免将视图模型设为可选或延迟初始化。 - 每次提取子视图后,在足以确认界面行为不变的最小范围内执行构建或测试。 请提供: - 重构后的界面及提取出的所有子视图 - 对新子视图的职责划分和数据流的简要说明 - 有意保留视图模型的位置及原因 - 为确认行为不变而实际执行的检查
    使用 Build iOS Apps 插件及其 SwiftUI 视图重构技能,整理 [NameOfScreen.swift] 的代码,保持界面的功能和外观不变。 约束条件: - 除非发现必须单独说明的缺陷,否则请保持行为、布局、导航和业务逻辑不变。 - 默认采用 MV 而非 MVVM。在引入新的视图模型之前,优先使用 `@State`、`@Environment`、`@Query`、`.task`、`.task(id:)` 和 `onChange`。只有当该功能确实需要视图模型时才保留它。 - 调整视图代码的顺序,从上到下依次排列存储属性、计算得出的状态、`init`、`body`、视图辅助代码和辅助方法,方便浏览。 - 将职责明确的界面区域提取为独立的 `View` 类型,通过少量明确的输入参数、`@Binding` 和回调传递数据与操作。不要把一个庞大的 `body` 拆成多个同样庞大的 `some View` 计算属性。 - 将较复杂的按钮操作和副作用从 `body` 移到简短的方法中,并将业务逻辑移到服务或模型中。 - 保持根视图树稳定。如果在局部使用条件视图或修饰符就能满足需求,请避免用顶层 `if/else` 分支在完全不同的界面之间切换。 - 重构时修正 Observation 模型的所有权问题。在 iOS 17 及更高版本上,使用 `@State` 持有根 `@Observable` 模型。除非 UI 确实需要这样表示状态,否则请避免将视图模型设为可选或延迟初始化。 - 每次提取子视图后,在足以确认界面行为不变的最小范围内执行构建或测试。 请提供: - 重构后的界面及提取出的所有子视图 - 对新子视图的职责划分和数据流的简要说明 - 有意保留视图模型的位置及原因 - 为确认行为不变而实际执行的检查

    重构单个界面,保持原有行为

    当一个 SwiftUI 文件越来越长,整个界面的代码都挤在一起,连小改动都让您担心出错时,就适合做这类重构。无需重新设计功能或引入新架构。请 Codex 在保持行为和布局的前提下,将界面拆分成小型子视图,并明确数据如何在视图之间传递,让后续改动更容易审查。

    这类重构可以使用 Build iOS Apps 插件。其中的 SwiftUI 视图重构技能有明确的取舍:默认优先采用 MV 而非 MVVM,将业务逻辑放在服务或模型中,优先使用视图自身的状态和环境依赖,仅在功能确实需要时才保留视图模型。

    可以让 Codex 做什么

    先指定一个具体的界面文件,请 Codex 在改善代码结构的同时保持原有行为。您可以将以下重构规则直接写入提示词:

    • 调整文件内的代码顺序,依次排列环境依赖、存储属性、通过计算得出的非视图状态、init、body、视图辅助代码和辅助方法,方便从上到下浏览。
    • 将职责清晰的界面区域提取为独立的 View 类型,通过少量明确的输入参数、@Binding 和回调传递所需的数据与操作。
    • 少用返回 some View 的辅助计算属性,并保持每个属性简短。避免把一个庞大的界面改写成一长串返回视图片段的私有计算属性。
    • 将复杂的按钮操作和副作用移出 body,并将业务逻辑移入服务或模型。
    • 保持根视图树稳定。优先在各个界面区域或修饰符中处理条件逻辑,避免通过顶层 if/else 分支切换整个界面。
    • 在重构时一并纠正 Observation 模型的所有权问题。在 iOS 17 及更高版本中,拥有根 @Observable 模型的视图应使用 @State 存储该模型。仅在需要兼容目标系统版本时才使用旧式可观察对象属性包装器。

    让 Codex 每拆分一步就做一次小范围验证

    重构后应验证界面行为是否保持一致。每次提取一个有实际意义的部分后,请 Codex 选择并执行能验证该界面的最小范围检查,例如构建、预览、测试或在模拟器中运行。随后,让 Codex 总结结构上有哪些变化,以及哪些方面有意保持了原样。

    实用建议

    先拆分,再讨论架构

    如果界面过于庞大,请 Codex 先将各个区域提取为独立视图,再考虑是否引入新的抽象层。视图树变得更短、结构更清晰后,往往就无需再添加视图模型。

    每个子视图只接收必要的数据和操作

    优先传入 let 常量、@Binding 和用途单一的回调,避免将父视图使用的整个模型传给每个子视图。这样既方便单独预览提取出的各个区域,也能减少它们无意间又依赖整个界面的可能。

    请 Codex 明确列出有意保留的行为和布局

    为便于确认重构是否安全,请 Codex 明确列出哪些方面保持了原样,包括业务规则、导航行为、数据持久化方式、分析数据的含义以及用户看到的布局。这样可以大幅缩短代码审查时间。

    技术栈

    需求

    UI 架构

    默认选项

    在 SwiftUI 中优先采用 MV,使用 @State 和 @Environment 管理状态和依赖,并将界面拆分为职责明确的小型 View 类型

    为什么需要

    在引入新的视图模型层之前,先让 Codex 简化视图树和状态传递方式,通常能让大型界面更易于维护。

    需求

    重构流程

    为什么需要

    插件中的 SwiftUI 视图重构技能为 Codex 提供了明确的规则,指导它在保留原有行为的同时提取子视图、使用 Observation 并整理涉及副作用的代码。

    需求

    验证

    默认选项

    xcodebuild、预览和有针对性的 UI 检查

    为什么需要

    与一次性重写相比,每次提取子视图后都做一次小范围构建或在模拟器中检查,更容易确认重构保留了原有行为。

    需求 默认选项 为什么需要
    UI 架构 在 SwiftUI 中优先采用 MV,使用 @State 和 @Environment 管理状态和依赖,并将界面拆分为职责明确的小型 View 类型 在引入新的视图模型层之前,先让 Codex 简化视图树和状态传递方式,通常能让大型界面更易于维护。
    重构流程 Build iOS Apps 插件 插件中的 SwiftUI 视图重构技能为 Codex 提供了明确的规则,指导它在保留原有行为的同时提取子视图、使用 Observation 并整理涉及副作用的代码。
    验证 xcodebuild 、预览和有针对性的 UI 检查 与一次性重写相比,每次提取子视图后都做一次小范围构建或在模拟器中检查,更容易确认重构保留了原有行为。

    相关使用场景