如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .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` 與回呼。請勿用多個大型 `some View` 計算屬性取代原本龐大的 `body`。 - 將較複雜的按鈕動作與副作用從 `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` 與回呼。請勿用多個大型 `some View` 計算屬性取代原本龐大的 `body`。 - 將較複雜的按鈕動作與副作用從 `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 先將各區段抽成獨立檢視,再考慮引入新的抽象層。檢視樹一旦變得更精簡、結構更清楚,往往就不必再新增檢視模型。

    讓每個子檢視的介面盡可能精簡

    優先傳入 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 行為的檢查 比起一次重寫整個畫面,每抽出一個子檢視就執行小範圍建置或在模擬器中檢查,更容易確認重構後的畫面仍保有原來的行為。

    相關應用案例