Flutter iOS构建报错：SharedPreferences相关Swift编译错误求助

问题分析 #

报错指向shared_preferences_foundation-2.3.0中的Swift代码，提示"变量绑定在条件中需要初始化器"，这是因为该版本的插件与你当前的Xcode/Swift版本存在兼容性问题。尽管你声明的shared_preferences版本是2.2.0，但它依赖的shared_preferences_foundation可能被自动拉取了2.3.0版本，而这个版本的Swift语法在Xcode 14.3.1下无法正常编译。

解决步骤 #

1. 锁定兼容的shared_preferences_foundation版本 #

在项目的pubspec.yaml中添加依赖覆盖，强制使用适配Xcode 14.x的版本：

dependency_overrides:
  shared_preferences_foundation: 2.2.1

2. 彻底清理并重新构建 #

执行以下命令清除缓存、重置依赖：

# 清除Flutter项目缓存
flutter clean
# 删除iOS目录下的Pod相关文件
rm -rf ios/Podfile.lock ios/Pods ios/Runner.xcworkspace
# 重新获取Flutter依赖
flutter pub get
# 进入iOS目录执行Pod安装
cd ios && pod install
# 返回根目录重新运行项目
cd .. && flutter run

3. 检查Xcode的Swift版本设置（可选） #

如果上述步骤无效，打开Xcode项目（ios/Runner.xcworkspace），确认以下设置：

• 选中Runner目标，进入Build Settings
• 搜索Swift Language Version，确保设置为Swift 5
• 同时检查SharedPreferencesPlugin目标的Swift版本也为Swift 5

4. 升级Flutter和插件（可选） #

若问题仍存在，尝试升级到最新稳定版Flutter和shared_preferences：

flutter upgrade
flutter pub upgrade shared_preferences

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