先看實際改動，再執行課程要求的測試或建置，最後對照題目決定能否提交；不要只憑 Codex CLI 的「完成」訊息交作業。這套 Codex CLI 課程程式碼驗收流程，適合 Python、前端及 Swift 初學者；若作業要求 Xcode 或 iOS 模擬器，再另外確認 Mac 環境是否符合課程要求。
- 第一次讓 Codex CLI 修改課程專案，想知道應按什麼次序檢查。
- 程式可以執行，但不熟悉 Git diff，擔心忽略不相關的檔案變更。
- 只有 Windows 電腦，想分清楚哪些檢查可在現有環境做，哪些需要 Xcode。
最後更新於 2026 年 10 月 13 日；Codex CLI 的操作描述依官方入門資料及官方程式碼庫文件核對。實際測試方式仍以你的課程說明和專案文件為準。
SECTION 01 修改前：先留下能比較、能還原的版本
Codex CLI 開始處理前，先確認終端機目前所在位置是課程專案資料夾，再打開題目要求和專案說明。你要清楚知道預期改哪些功能、哪些檔案應該保留，以及老師要求提交什麼；任務描述越具體，之後越容易判斷變更有沒有越界。
如果專案使用 Git，先檢查工作目錄是否已有自己尚未保存的改動。可用 git status --short 查看檔案狀態；若你不熟悉 Git，也可以先複製一份專案作為還原點。切勿把未備份的作業直接交給工具大幅修改，否則發現原有功能被改壞時，可能難以分辨問題從何而來。
| 時點 | 先確認什麼 | 留下的核對依據 |
|---|---|---|
| 開始修改前 | 專案位置、題目要求、目前未保存的改動 | Git 狀態、備份副本或已保存版本 |
| 工具完成後 | 哪些檔案新增、刪除或修改 | Git diff 與檔案清單 |
| 準備提交前 | 測試結果、題目要求、提交檔案 | 可重現的執行步驟與逐項核對結果 |
Codex CLI 開始工作前，怎樣保留原始作業？
有 Git 經驗，就先保存一個可辨識的版本，再開始新的修改；沒有 Git 經驗，就複製整個專案到另一個資料夾，並確認副本內有課程需要的檔案。不要只截圖或記住原本畫面，因為那無法還原程式內容，也不容易逐項比較。
官方入門資料及程式碼庫文件可能隨工具版本更新。遇到操作介面、確認方式或權限選項不同時，請對照官方 Codex CLI 說明，不要把網路上的舊步驟當成目前功能的保證。
SECTION 02 修改完成後：先查檔案清單，再讀 Git diff
不要先按提交，也不要只讀工具對任務的文字摘要。先看它實際碰了哪些檔案：新增、刪除、改名或修改的項目，都要與原本要求對照。若題目只要求修正一個輸入錯誤，卻連帶改動設定檔、其他頁面或無關功能，就先停下來查明原因。
Git diff 是把目前版本與另一個版本的差異逐項呈現，方便你檢查實際程式內容；工具的摘要則只是說明，不能代替檔案核對。Git 官方手冊說明了差異比較的用途與選項，初學者可先查看 git diff 文件。有 Git 專案時，可依序執行：
git status --short
git diff --name-only
git diff
第一個指令協助你查看檔案狀態，第二個列出有差異的檔案名稱，第三個顯示內容差異。若專案尚未追蹤新檔案，差異檢視未必會以你預期的方式完整呈現它們，因此仍要檢查新增檔案及專案資料夾；不要把空白差異誤認為「沒有任何變更」。
怎樣確認 Codex CLI 改了哪些檔案？
先看檔案名稱清單，再打開每一項變更逐段檢查；對新增檔案，要確認它是否真的屬於題目要求。每一項差異都應能回答「這是為了完成哪個要求？」答不出來，就先不要提交。
SECTION 03 理解改動後：你能否用自己的話說明原因？
看得懂差異，不等於明白改動。至少要能指出主要修改位置、輸入與輸出如何變化，以及新增的相依套件、設定或專案檔案是否必要。這不是要你立刻精通整份程式，而是避免交出一段自己無法解釋、也不知道如何檢查的程式碼。
| 發現的改動 | 提交前的核對問題 | 建議動作 |
|---|---|---|
| 修改範圍符合題目 | 每個變更是否對應一項要求？ | 繼續執行課程測試 |
| 出現新套件或設定檔 | 課程或專案文件是否要求它？ | 查明用途及安裝、執行方式 |
| 改到題目以外的程式 | 這項變更是否有明確必要？ | 暫停，追問原因或還原後重查 |
| 看不懂主要邏輯 | 你能否說明程式如何符合題意？ | 先釐清，再決定是否保留 |
如果有一段改動看不懂，還可以交作業嗎？
先不要把它當成可接受的修改。請要求工具逐段解釋變更對應的題目條件，再用原始版本和實際差異自行核對；如果仍無法說明，或改動與課程知識點無關，就先還原或向老師、助教確認。工具給出的理由可以幫你理解，但不代表該段程式已符合評分要求。
SECTION 04 執行測試後：分清「已通過」和「尚未檢查」
先依課程提供的測試步驟、範例輸入和驗收條件操作，不要自行猜一個命令就把結果當成標準。若專案附有說明文件，依文件啟動程式和執行測試；若課程只要求特定情境，先完成那些情境，再記下測試輸入、看到的結果，以及是否出現錯誤。
Python 專案如果使用標準函式測試框架，可查看官方 unittest 文件了解如何執行測試；但課程專案可能使用不同工具，仍須以專案說明為準。前端頁面則按題目實際要求檢查操作與顯示，不要假設「頁面能開啟」就表示表單、錯誤輸入和其他指定行為都正常。
Codex CLI 寫完的課程作業，為什麼仍要自己跑測試？
因為工具完成修改，只表示它已產生變更；實際執行才能檢查你的專案環境中是否能啟動，以及課程指定情境是否得到預期結果。測試通過只證明被執行的部分符合檢查條件，沒有跑過的頁面、輸入和例外情況仍未驗證。
SECTION 05 提交前：按題目逐項作決定，不盲目追加修改
把題目要求拆成可觀察的結果：輸入什麼、程式應做什麼、輸出或畫面應呈現什麼。逐項實際操作，確認專案仍能啟動、測試結果可重現，並再次檢查提交資料夾中是否有題目指定的檔案。除非課程要求，勿把暫存檔、私人資料或不必要的環境設定一併交出。
測試通過，就代表可以直接提交嗎？
不一定。先確認測試涵蓋題目要求，再核對未被測試的必要功能、提交格式與檔案內容；若測試通過但指定操作仍失敗，或作業說明要求額外證明，就不能只憑測試結果判定完成。失敗時，先判斷是程式錯誤、執行環境問題，還是自己理解錯題目，再決定下一步；不要因為工具提出了更多修改，就不經檢查全部接受。
用以下條件分流：
- 若差異都能對應到題目要求、你能說明主要改動，而且課程指定測試已完成並符合預期，再按作業格式檢查提交檔案。
- 若差異範圍不明、出現無法解釋的套件或設定，暫停提交，先釐清或還原比較。
- 若測試命令失敗，但專案文件指出需要特定環境，先查環境條件，不要立即把失敗判定為程式錯誤。
- 若作業明確要求 Xcode 建置、iOS 模擬器或其他 macOS 專屬驗收，把相關部分留到相容的 Mac 環境檢查；通用程式碼閱讀與差異核對仍可先在現有電腦完成。
SECTION 06 需要 Xcode 時：把通用檢查與 Mac 專項驗收分開
沒有 Mac，還能檢查 Codex CLI 修改的 iOS 專案嗎？
可以先檢查檔案差異、閱讀程式碼、核對題目，並執行課程在現有環境支援的部分；但如果交付條件明確要求 Xcode 建置或 iOS 模擬器結果，不能把通用程式碼檢查當成已完成該項驗收。Xcode 的執行與測試方式，應依官方 Xcode 文件及在模擬器或實體裝置執行 App 的說明核對；測試結果亦可參考官方測試結果說明。
若你只有 Windows，先讀課程的交付要求，列出必須在 Xcode 執行的項目，再決定是否需要借用或租用 Mac。若想了解沒有本機 Mac 時的學習安排，可參考沒有本地 Mac 時的臨時 Mac 方案。通用測試可留在現有設備完成；需要 Xcode 或模擬器驗收時，則按課程所需核對環境與交付方式。
對只需一般 Python 或前端測試的作業，先用現有電腦通常更直接；若學校設備限制安裝軟體，或課程指定 Xcode，你可能需要處理本機無法執行 macOS 工具、學校權限不足，以及臨時環境難以保留等問題。這時可比較自備 Mac 與遠端 Mac：前者適合長期、頻繁使用及需要本機周邊設備的情況；若只是完成階段性課程驗收，VPSNIX 提供按期使用的遠端 Mac 方案，可先查看方案與計費資料，並確認課程所需的 Xcode 工作流程是否適用，再決定是否使用。