React Native开发中Xcode提示UserInterfaceState.xcuserstate无法解锁求助

错误信息 #

无法解锁文件“UserInterfaceState.xcuserstate”。该文件存储在只读卷中，请尝试将卷设置为可写或将文件复制到其他卷。

以下是几个经过验证的解决方案，按操作复杂度排序：

1. 删除冗余的用户状态文件 #

• 完全关闭Xcode和你的React Native项目
• 找到项目里的.xcodeproj或.xcworkspace文件，右键选择「显示包内容」
• 进入xcuserdata文件夹，找到以你用户名命名的.xcuserdatad子文件夹
• 删除其中的UserInterfaceState.xcuserstate文件
• 重新打开项目，Xcode会自动生成新的状态文件（这个文件仅存储界面布局偏好，删除无业务影响）

2. 修复项目目录权限 #

• 打开终端，切换到你的React Native项目根目录：

  cd /你的项目路径/react-native-project
  

• 给iOS目录递归添加读写权限：

  sudo chmod -R 777 ./ios
  

• 或者精准修改Xcode项目文件的归属：

  chown -R $(whoami) ./ios/YourProjectName.xcodeproj
  

  注意把YourProjectName替换成你实际的项目名称

3. 清理Xcode缓存并重启 #

• 关闭Xcode
• 终端执行命令清理Xcode缓存和派生数据：

  rm -rf ~/Library/Caches/com.apple.dt.Xcode
  rm -rf ~/Library/Developer/Xcode/DerivedData
  

• 重启Xcode后重新打开项目

4. 迁移项目到可写存储卷 #

如果你的项目存放在只读卷（比如外接只读硬盘、系统只读分区）上：

• 把整个React Native项目文件夹复制到Mac内置硬盘（确保目标磁盘未开启只读模式）
• 从新的位置打开项目进行开发

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