Flutter macOS项目构建失败：提示找不到FlutterMacOS模块

问题场景 #

基于Intel的macOS Sequoia 15.2设备，使用Flutter 3.27.0（3.24.x版本也存在相同问题）创建基础macOS应用，执行flutter run时出现编译错误：

/Users/diegum/Development/pijarolata_hervida/macos/Runner/MainFlutterWindow.swift:2:8: error: no such module 'FlutterMacOS'
import FlutterMacOS
       ^

解决方案 #

1. 确认Flutter macOS桌面组件完整 #

先确保Flutter已启用并安装macOS桌面支持组件：

flutter doctor --enable-macos-desktop
flutter doctor -v

检查输出中Xcode部分是否明确支持macOS开发，无缺失组件提示。

2. 彻底清理项目缓存与依赖 #

• 执行Flutter清理命令：

  flutter clean
  

• 删除项目中以下目录和文件：
  • macos/Pods
  • macos/Podfile.lock
  • 项目根目录下的.dart_tool、build文件夹
• 进入macos目录，重新集成并安装依赖：

  cd macos
  pod deintegrate
  pod install
  

3. 验证Xcode项目配置 #

打开项目的macos/Runner.xcodeproj，检查以下配置：

• 进入Build Settings，搜索Framework Search Paths，确认包含$(FLUTTER_FRAMEWORK_DIR)路径，且路径未被错误修改
• 检查General标签下的Frameworks, Libraries, and Embedded Content，确认FlutterMacOS.framework已正确添加，且嵌入方式为Embed & Sign

4. 检查Flutter环境变量 #

确保系统环境变量中FLUTTER_ROOT指向正确的Flutter安装路径：

echo $FLUTTER_ROOT

输出应与flutter doctor -v中显示的Flutter路径一致，若不一致需重新设置环境变量。

5. 针对Intel架构的额外检查 #

由于是Intel Mac，需确保CocoaPods使用正确的架构：

• 在项目的macos/Podfile顶部添加指定最低macOS版本（匹配Flutter要求）：

  platform :osx, '10.15'
  

• 若仍有问题，可在Podfile末尾添加架构配置后重新执行pod install：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
        config.build_settings['ARCHS'] = 'x86_64'
      end
    end
  end
  

内容的提问来源于stack exchange，提问作者Diegum