You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter项目iOS端flutter_root缺失报错,如何添加至User-Defined?

解决Flutter iOS项目中flutter_root缺失导致的PhaseScriptExecution错误

这个报错我之前也踩过坑,本质就是Xcode的iOS工程找不到Flutter SDK的安装路径,咱们手动给它补上flutter_root就行,步骤超清晰:

  • 打开你的Flutter项目里的iOS工程:直接双击项目根目录下ios文件夹里的.xcworkspace文件(别开.xcodeproj,不然可能有依赖加载问题)
  • 在Xcode左侧的项目导航栏,选中最顶部的项目根节点(不是下面的Target哦)
  • 切换到Build Settings标签页,嫌翻页麻烦的话可以用右上角搜索框直接搜User-Defined快速定位
  • 点击User-Defined区域左上角的+按钮,选择Add User-Defined Setting
  • 把新设置的名称改成flutter_root(注意大小写完全匹配,不能写错)
  • 接下来填写Flutter SDK的路径:
    • 如果你是用Homebrew安装的Flutter,路径大概是/opt/homebrew/Caskroom/flutter/[你的具体版本号]/flutter,比如/opt/homebrew/Caskroom/flutter/3.13.9/flutter
    • 要是手动下载的SDK,就填你解压后存放Flutter的文件夹路径,比如~/Documents/flutter(~代表你的用户根目录)
    • 嫌找路径麻烦?打开终端输入which flutter,得到的结果比如/Users/xxx/Documents/flutter/bin/flutter,把末尾的/bin/flutter删掉,剩下的就是正确的flutter_root路径
  • 填完路径后按回车保存,然后试试重新编译项目(快捷键Command+B)

小提示:如果还是报错,先试试用Command+Shift+K清理Xcode缓存,或者重启Xcode再试,另外确保你的Flutter SDK路径里没有空格或者特殊字符,不然也可能触发奇怪的问题。

Command PhaseScriptExecution报错截图

内容的提问来源于stack exchange,提问作者AyadRocketfy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.09 15:17:33