跳到主内容

设置 macOS 开发环境

配置您的开发环境，以便在 macOS 设备上运行、构建和部署 Flutter 应用。

了解如何设置您的开发环境，以便在 macOS 桌面平台上运行、构建和部署 Flutter 应用。

设置开发工具

#

借助 Xcode，您可以运行 Flutter 应用于 macOS，以及编译和调试原生 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 桌面开发环境，您可以继续您的 Flutter 学习之旅，同时在 macOS 上进行测试，或开始扩展与 macOS 的集成。

继续学习 Flutter
为 macOS 构建

除非另有说明，此网站上的文档反映了 Flutter 3.38.6。页面上次更新于 2026-01-16。 查看源代码 或 报告问题。