删除用户目录下.gradle文件夹后自动生成registry.bin.lock文件求助

问题背景 #

删除用户目录下.gradle文件夹后，该目录会立即重建并仅包含registry.bin.lock文件，无法删除此文件；重装Gradle Wrapper时出现报错：

Error: Unexpected lock protocol found in lock file. Expected 3, found 50

（注：相关截图显示用户目录下的.gradle文件夹仅存在registry.bin.lock单个文件，无法正常删除）

解决步骤 #

1. 终止所有Gradle相关进程 #

锁文件无法删除通常是因为有Gradle/Java进程在占用它：

• Windows：打开任务管理器，结束所有gradle.exe及关联的java.exe进程
• macOS/Linux：终端执行以下命令终止进程：

  pkill -f gradle
  

  若未生效，可先通过ps aux | grep gradle找到进程PID，再用kill -9 <PID>强制终止

2. 强制删除.gradle目录及锁文件 #

进程终止后，彻底清理残留的锁文件：

• Windows：
  命令提示符执行：

  rmdir /s /q %USERPROFILE%\.gradle
  

  或PowerShell执行：

  Remove-Item -Recurse -Force $HOME\.gradle
  

• macOS/Linux：

  rm -rf ~/.gradle
  

3. 重装Gradle Wrapper #

进入项目根目录，执行Wrapper初始化命令（替换<指定版本号>为你需要的Gradle版本，比如7.6）：

gradle wrapper --gradle-version <指定版本号>

如果本地没有Gradle环境，可先手动下载对应版本的Gradle压缩包，解压后配置GRADLE_HOME环境变量并添加到系统PATH，再执行上述命令

4. 验证修复 #

执行项目构建命令确认问题解决：

• macOS/Linux：./gradlew build
• Windows：gradlew.bat build

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