如何解决“Xcode构建缺少预期的TARGET_BUILD_DIR构建设置”错误？

云原生阿岚

2026-7-10

解决Flutter在VS Code中运行模拟器报错“Xcode构建缺少预期的TARGET_BUILD_DIR构建设置”

重置Flutter iOS构建缓存
依次执行以下命令：
```
flutter clean
flutter pub get
rm -rf ios/Pods ios/Podfile.lock
cd ios && pod install && cd ..
```
缓存冲突是这类问题的常见诱因，清掉旧缓存重新生成能解决VS Code与Xcode的配置不一致问题。
核对VS Code的设备选择
确认VS Code右下角设备选择器里，选中的是和Xcode中可运行的完全一致的模拟器，要包含完整的iOS版本和设备型号（比如选“iPhone 15 (iOS 17.0)”而非仅显示“iPhone 15”的条目）。部分情况下VS Code会识别出重复模拟器，选带完整标识的那个即可。
手动为VS Code指定TARGET_BUILD_DIR路径
1. 打开项目的ios/Runner.xcworkspace，在Xcode中选中Runner目标，进入Build Settings，搜索TARGET_BUILD_DIR，复制它的完整配置值（一般是$(BUILD_DIR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)）
2. 在VS Code中新建或打开.vscode/launch.json，添加环境变量配置：
```
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Flutter",
            "request": "launch",
            "type": "dart",
            "env": {
                "TARGET_BUILD_DIR": "粘贴你复制的配置值"
            }
        }
    ]
}
```
确保Flutter与Xcode版本匹配
执行flutter doctor检查版本兼容性，确保两者都是稳定版且版本匹配（比如Flutter 3.16+对应Xcode 15+）。如果不兼容，执行flutter upgrade升级Flutter，或在App Store升级Xcode到最新稳定版。
重置VS Code Flutter插件状态
关闭VS Code，删除~/.vscode/extensions/flutter.flutter-*目录下的缓存（替换为实际插件版本目录），重新打开VS Code后，在命令面板（Ctrl+Shift+P）执行Flutter: Reload Flutter Project。