跳到主內容

設定 macOS 開發環境

配置您的開發環境，以便為 macOS 裝置執行、構建和部署 Flutter 應用。

瞭解如何設定開發環境，以便為 macOS 桌面平臺執行、構建和部署 Flutter 應用。

設定開發工具

#

藉助 Xcode，您不僅可以在 macOS 上執行 Flutter 應用，還可以編譯和除錯原生的 Swift 和 Objective-C 程式碼。

  1. 安裝 Xcode

    如果您尚未安裝，請下載並安裝最新版本的 Xcode。

    如果您已經安裝了 Xcode，請使用最初安裝時所用的相同方式將其更新到最新版本。

  2. 設定 Xcode 命令列工具

    要配置 Xcode 命令列工具以使用您已安裝的 Xcode 版本，請在您首選的終端中執行以下命令：

    sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

    如果您是從其他地方下載的 Xcode，或者需要使用不同版本，請將 /Applications/Xcode.app 替換為相應的路徑。

  3. 同意 Xcode 許可協議

    設定好 Xcode 及其命令列工具後，請同意 Xcode 的許可協議。

    1. 開啟您偏好的終端。

    2. 執行以下命令以檢視並簽署 Xcode 許可協議。

      sudo xcodebuild -license

    3. 閱讀並同意所有必要的許可協議。

      在同意每項許可協議的條款之前，請仔細閱讀。

      一旦您成功接受了所有必要的許可協議，該命令將輸出如何檢視許可協議的資訊。

  4. 安裝 CocoaPods

    為了支援使用原生 macOS 程式碼的 Flutter 外掛，請安裝最新版本的 CocoaPods。

    請按照 CocoaPods 安裝指南安裝 CocoaPods。

    如果您已經安裝了 CocoaPods，請按照 CocoaPods 更新指南進行更新。

驗證您的設定

#

  1. 檢查工具鏈問題

    要檢查 macOS 開發環境配置是否存在任何問題，請在您首選的終端中執行 flutter doctor 命令：

    flutter doctor -v

    如果您在 Xcode 部分看到任何錯誤或待辦事項，請完成並解決它們，然後再次執行 flutter doctor -v 以驗證更改。

  2. 檢查 macOS 裝置

    為了確保 Flutter 能正確發現並連線到您的 macOS 裝置，請在您首選的終端中執行 flutter devices：

    flutter devices

    如果一切設定正確，至少應該有一個平臺標記為 macos 的條目。

  3. 排查設定問題

    如果您需要解決任何設定問題，請檢視安裝和設定故障排除。

    如果您仍然有問題或疑問，請透過 Flutter 的任一社群渠道聯絡我們。

開始 macOS 開發

#

恭喜！現在您已經為 Flutter 設定好了 macOS 桌面開發環境，您可以一邊在 macOS 上進行測試一邊繼續您的 Flutter 學習之旅，或者開始擴充套件與 macOS 的整合。

繼續學習 Flutter
為 macOS 構建

除非另有說明，本網站上的文件反映的是 Flutter 3.41.5 版本。頁面最後更新於 2026-05-05。 檢視原始碼 或 報告問題。