macOS构建Flutter应用时恼人的Linker警告问题求助

问题重现 #

执行常规构建命令时出现链接器警告：

ash ~ >flutter build macos

Running pod install...                                             20.1s
ld: warning: ignoring duplicate libraries: '-lc++'
ld: warning: ignoring duplicate libraries: '-lc++'
ld: warning: reexported library with install name '/System/Library/Frameworks/ApplicationServices.framework/Versions/A/Frameworks/SpeechSynthesis.framework/Versions/A/SpeechSynthesis' found at '/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/ApplicationServices.framework/Versions/A/Frameworks/SpeechSynthesis.framework/Versions/A/SpeechSynthesis.tbd' couldn't be matched with any parent library and will be linked directly 

添加--verbose参数构建时无警告，可正常完成，但常规构建警告无法通过修改Xcode Build Phases、Build Options消除。

解决方案 #

1. 彻底清理缓存与重建依赖 #

• 执行Flutter清理：

  flutter clean
  

• 进入项目的macos目录，删除Pod相关文件：

  cd macos
  rm -rf Pods Podfile.lock
  

• 重新安装Pod依赖：

  pod install
  

2. 检查并修正链接器参数重复问题 #

• 打开Xcode项目（macos/Runner.xcworkspace），选中Runner target，进入Build Settings
• 搜索Other Linker Flags，查看是否存在重复的-lc++条目，保留一个即可（建议保留$(inherited)以继承Pod依赖的设置）
• 若发现第三方Pod的spec文件中重复添加了-lc++，可在Podfile中通过post_install钩子移除重复项：

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

3. 修复SpeechSynthesis框架重导出警告 #

• 在Xcode的Build Settings中搜索Reexported Libraries，若存在SpeechSynthesis.framework条目，直接移除
• 进入Build Phases -> Link Binary With Libraries，检查是否直接添加了SpeechSynthesis.framework，若有则移除，改为依赖ApplicationServices.framework（系统框架会自动包含SpeechSynthesis子框架）
• 确认Framework Search Paths中没有重复的系统框架路径，仅保留默认的$(inherited)和系统SDK路径

4. 统一Flutter构建的链接器参数 #

在项目的macos目录下创建flutter_build_config.yaml文件，添加如下配置，强制统一链接器参数：

target:
  macos:
    linker_args:
      - "-lc++"
      - "-undefined dynamic_lookup"

添加后重新执行flutter build macos测试。

关于--verbose模式无警告的说明 #

Flutter在--verbose模式下会生成更详细的构建日志，同时可能调整了链接器参数的生成逻辑，跳过了部分重复库的检查步骤，或者使用了不同的缓存策略，因此不会触发警告，但常规构建的参数逻辑仍需调整才能消除警告。

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