Flutter新项目在Android Studio运行失败：Gradle锁文件协议异常

这个错误是由于Gradle缓存中的锁文件损坏导致的，以下是具体解决步骤：

• 关闭Android Studio及所有关联的Java/Gradle进程
  打开任务管理器（Windows）或活动监视器（Mac），结束所有java、gradle相关的运行进程，避免文件被占用。

• 删除Gradle缓存文件

  1. 删除项目根目录和android子目录下的.gradle文件夹
  2. 删除用户目录下的Gradle全局缓存：
     • Windows：C:\Users\<你的用户名>\.gradle\caches
     • Mac/Linux：~/.gradle/caches

• 清理Flutter项目缓存并重新获取依赖
  在项目根目录打开终端，依次执行：

  flutter clean
  flutter pub get
  

• 重新构建项目
  打开Android Studio，点击工具栏的「Sync Project with Gradle Files」按钮，待同步完成后重新运行项目。

如果以上步骤无效，可尝试：

• 检查android/build.gradle中的Gradle插件版本与Flutter版本是否兼容，必要时调整版本号
• 关闭Gradle离线模式：进入Android Studio设置 → Build, Execution, Deployment → Build Tools → Gradle，取消勾选「Offline work」

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