跳到主内容

设置 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。 查看源码 或 报告问题。