Flutter 3.47 的 iOS 專案要在 macOS 上使用 Xcode 建置並於模擬器驗收；沒有本地 Mac 的學生，可用遠端 Mac 完成這一步，再按課程需要決定是否繼續使用。本文適合正在寫第一個 Flutter 專案、但尚未跑通 iOS 建置的初學者。
適合只有 Windows 或學校電腦、需要補上 macOS 環境的學習者；若目前只是練習 Dart 語法或編輯介面程式碼，可以先留在現有電腦，不必急著換設備。
最後更新於 2026 年 10 月 3 日；版本發布資訊與操作邊界已對照 Flutter 官方發布紀錄、Flutter iOS 設定文件及 Apple Xcode 元件安裝說明核對。
動手前：先分清楚課程要完成哪一段
Flutter 3.47 官方發布紀錄列出此版本於 2026 年 8 月 12 日發布；本篇聚焦的是用 Flutter 專案啟動 iOS Simulator 並檢查結果，不是上架 App，也不保證每個課程專案或外掛都能不經調整就成功執行。版本資訊請以官方發布紀錄為準。
寫 Dart、修改介面、閱讀大部分 Flutter 程式碼，通常可以在你現有的電腦上進行。iOS 版本的建置與模擬器操作，則需要 macOS 上的 Xcode 工具鏈；這是環境需求，不是把程式碼換到 Mac 就會自動解決所有錯誤。Flutter 的 iOS 開發設定列出這些工具的配置路徑。
| 學習任務 | 現有 Windows 電腦 | macOS 與 Xcode |
|---|---|---|
| 編輯 Flutter 程式碼、整理課程檔案 | 可繼續進行 | 可進行 |
| 建置 iOS 版本並檢查建置結果 | 不適合作為 iOS 建置環境 | 用於 iOS 建置 |
| 啟動 iOS Simulator 驗收畫面 | 無法以本機 Windows 模擬器取代 | 安裝可用元件後操作 |
| 發布 App 或測試真機 | 這不是本教程的驗收目標 | 仍須按 Apple 與課程要求完成相應流程 |
環境選擇：先看目前缺少什麼
沒有本地 Mac，不代表必須立刻購買。先按課程的驗收要求選擇環境，尤其要確認學校電腦是否允許安裝開發工具、專案是否能依課程規定轉移，以及遠端操作是否符合學校的資料政策。
| 路線 | 適合情況 | 需要留意 |
|---|---|---|
| 沿用目前電腦 | 正在學 Dart、寫共用程式碼，課程暫時不要求 iOS 建置 | 無法完成本機 iOS Simulator 驗收 |
| 使用學校提供的 Mac | 校方已提供並授權使用，且課程允許安裝或使用 Xcode | 管理限制應向負責人確認，不要自行繞過 |
| 使用遠端 Mac | 暫時需要 macOS、Xcode 或模擬器，手邊沒有可用 Mac | 需要穩定連線；操作前要確認檔案保存與權限 |
| 購買本地 Mac | 長期需要固定使用 macOS，或課程另有本機硬體需求 | 應把購置與後續使用成本一併評估 |
Flutter 官方說明涵蓋多個開發平台，但不同平台的建置目標並不相同；可以先閱讀多平台開發說明，再依課程是否要求 iOS 模擬器，決定何時進入 macOS 環境。若想先了解遠端 Mac 的使用方式，可參考 NodeMini 遠端 Mac 方案資訊。
連線前：整理專案與使用權限
在開始安裝前，先準備課程專案的副本，並確認你有權在遠端環境安裝或使用 Flutter SDK、Xcode 與課程要求的工具。遠端桌面、終端機和檔案傳輸是不同的操作入口：即使已經看到 Mac 桌面，也仍要確認終端機能存取專案所在位置。
如果專案目前只在學校管理的電腦上，先查看課程允許的檔案保存與轉移方式。管理員限制安裝、登入或複製檔案時，應停止並詢問學校負責人，不要自行變更系統管理設定。遠端操作亦應留意課程資料是否可以存放在該環境。
進入 Mac 後，先確認你可以開啟終端機、找到專案資料夾，並知道如何保存變更。終端機是輸入文字命令的工具；後續的 Flutter 指令需要從專案所在位置執行，避免在錯誤資料夾建立或執行程式。
安裝 Flutter SDK：讓終端機找到工具
Flutter SDK 是執行 Flutter 命令、建立與建置專案所需的工具集合。依照Flutter 官方手動安裝文件下載適合目前環境的 SDK，並按官方步驟設定終端機的 PATH。PATH 可以理解為終端機尋找命令的路徑清單；路徑未設定好時，系統可能無法辨識 flutter。
Flutter 版本、晶片類型與 macOS 版本應以當下官方文件及遠端環境實際狀況核對，不要假設每台 Mac 都預先安裝好相同工具。安裝完成後開啟新的終端機視窗，在一般目錄輸入：
flutter --version
flutter doctor -v
第一個命令用來確認目前執行的 Flutter 版本；第二個命令會檢查 Flutter 開發環境並列出診斷結果。若顯示找不到 flutter，先核對 SDK 路徑和 PATH，再重新開啟終端機。命令用途可參考 Flutter CLI 官方參考；不要因為某一行檢查成功，就略過後續的 Xcode 項目。
設定 Xcode：補齊 iOS 建置工具
依照Flutter iOS 設定文件安裝或開啟 Xcode，並完成文件要求的初始設定。首次啟動若出現元件下載、授權或其他設定提示，應先按官方流程完成；需要額外的模擬器元件時，參照 Apple 的 Xcode 元件安裝指引。
完成設定後再次執行：
flutter doctor -v
閱讀診斷輸出中的 iOS toolchain 區段。如果它指出 Xcode 路徑、命令列工具或授權未完成，先處理該項，再重新檢查。若診斷已通過，但找不到模擬器，檢查 Xcode 是否已有可用的 iOS Simulator 元件；不要把「Xcode 已開啟」當成「所有 iOS 工具都已準備好」。
| 檢查項目 | 完成後應確認的內容 | 未完成時的下一步 |
|---|---|---|
| Flutter SDK | 終端機能回報版本與診斷結果 | 核對安裝位置及 PATH |
| Xcode | Flutter 診斷沒有指出 iOS 工具鏈問題 | 依診斷提示完成設定 |
| Simulator 元件 | flutter devices 列出可用的 iOS 模擬器 |
檢查 Xcode 元件是否已安裝 |
| 專案位置 | 終端機能進入課程專案目錄 | 找回正確副本並確認存取權限 |
首次執行：從專案目錄到模擬器畫面
先切換到課程專案資料夾，再檢查可用裝置：
cd 專案資料夾路徑
flutter devices
flutter devices 用來列出 Flutter 可使用的裝置。若 iOS Simulator 已啟動並出現在清單中，按照 Flutter CLI 提示選擇目標；若同時列出多個目標，就明確使用清單中的裝置識別碼：
flutter run -d 裝置識別碼
把範例中的文字換成診斷輸出實際列出的識別碼，不要直接照抄。若課程尚未提供專案，可以先依Flutter 建立新應用指南建立練習專案，再從專案資料夾執行。
建置時要分辨三種不同狀況。終端機顯示 Dart 或專案程式錯誤，先依錯誤位置檢查程式碼；診斷指出 Xcode 或 iOS toolchain 問題，回到 Xcode 設定；裝置清單沒有模擬器，則先確認 Simulator 元件及其啟動狀態。不要只看到命令開始執行，就判定作業已完成。
| 現象 | 優先判斷 | 建議處理 |
|---|---|---|
flutter 命令無法辨識 |
SDK 路徑或 PATH 設定問題 |
回查官方安裝步驟，並重新開啟終端機 |
| iOS toolchain 顯示待處理項目 | Xcode 設定、授權或工具元件未完成 | 依 flutter doctor -v 指示處理 |
| 裝置清單沒有 iOS Simulator | 模擬器元件未安裝或未啟動 | 檢查 Xcode 元件與模擬器狀態 |
| 已開始建置但出現程式錯誤 | 專案程式碼或相依套件問題 | 依錯誤訊息回到對應程式碼或課程設定 |
若錯誤內容看不懂，保留完整診斷輸出與發生步驟，再對照 Flutter 官方安裝問題排查文件。避免只複製最後一行錯誤，因為前面的診斷訊息可能已指出真正缺少的環節。
結束前：完成驗收並保存專案
執行成功的判斷依據，是 iOS Simulator 中能看到預期的課程頁面，而且終端機沒有仍在等待處理的建置錯誤。這只代表完成本教程的模擬器驗收，不等同真機測試或 App 發布。
- [ ] 確認目前終端機位於正確的課程專案資料夾。
- [ ] 確認
flutter --version顯示的版本符合課程要求。 - [ ] 查看
flutter doctor -v，確認 iOS toolchain 沒有未處理項目。 - [ ] 查看
flutter devices，確認選擇的是預期的 iOS Simulator。 - [ ] 確認模擬器畫面顯示課程頁面，並檢查終端機是否仍有錯誤。
- [ ] 儲存程式變更，按課程允許的方式確認專案副本已保存，再結束遠端連線。
Windows 可以繼續用來編輯共用的 Flutter 程式碼；需要重新建置或在 iOS Simulator 驗收時，再回到已配置好的 macOS 環境。若作業要求實際 iPhone 或 iPad 測試，模擬器不能取代真機，需先確認課程的設備與測試要求。
新手常見問題
沒有本地 Mac 時，iOS 部分怎麼安排？
先在現有電腦完成課程允許的程式碼練習與專案整理。當作業要求 iOS 建置或模擬器驗收，再使用學校提供且獲准使用的 Mac，或評估遠端 Mac。若課程尚未進入 iOS 部分，無須為了練習 Flutter 基礎立刻購買設備。
Flutter 3.47 的 Xcode 環境如何判斷完成？
執行 flutter doctor -v 查看 iOS toolchain 診斷，再用 flutter devices 確認可用的模擬器。兩項檢查用途不同：前者檢查開發環境，後者確認 Flutter 能找到執行目標。若其中一項未通過，依官方診斷逐項處理，不要以另一項通過代替完整驗收。
專案已經開啟，但 iOS 模擬器沒有出現在清單裡？
先確認 Xcode 的 Simulator 元件已安裝，再啟動可用的模擬器並重新執行 flutter devices。若清單仍沒有目標，查看 flutter doctor -v 與 Xcode 元件狀態；此時先處理環境或目標缺失，不要把問題當成 Flutter 頁面程式碼錯誤。
Windows 上的程式碼如何接續到 Mac？
先保存課程專案，再依學校規定或課程指定方式將副本放到 Mac 可存取的位置；在 Mac 端進入該專案目錄，確認 Flutter SDK 與 Xcode 狀態後再執行。若管理政策不允許安裝、傳送或存放資料，先向管理人員確認可用流程，不要自行嘗試解除限制。
若課程只需要偶爾完成 iOS 建置，沿用 Windows 寫程式、在需要驗收時使用 macOS，通常比為一次作業購置整套設備更符合使用情境；但遠端方案依賴網路連線，檔案也必須妥善保存，長期高頻使用或需要實體介面的學習者，應比較自購 Mac、學校設備與其他合規選項。確認課程確實需要 Mac、但手邊沒有可用設備時，可先查看 NodeMini 遠端 Mac 的使用方式，再依作業週期決定是否租用。