跳转至正文

配置 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.44.0 版本。本页面最后更新时间：2026-06-15。查看文档源码 或者 为本页面内容提出建议。