Xcode 11.0 重命名文件提示Rename Failed错误的原因及解决方案问询

常见原因 #

• 文件权限异常：项目目录或目标文件的读写权限被限制，Xcode没有修改文件名称的系统权限
• Xcode缓存冲突：DerivedData缓存损坏，或者项目索引文件异常，导致Xcode识别文件状态出错
• 项目配置锁死/损坏：项目的.xcodeproj/.xcworkspace配置文件被其他进程占用，或者内部配置已损坏，修改文件名的操作无法同步写入配置
• 文件系统大小写限制：如果当前Mac磁盘使用的是大小写不敏感的文件系统，仅修改文件名大小写（例如main.m改Main.m）会被系统判定为同名文件，触发重命名失败
• Git状态冲突：如果目标文件处于Git未提交修改、合并冲突状态，部分Xcode版本会阻止重命名操作，避免Git仓库状态异常

修复方法 #

• 调整目录权限：右键点击项目根目录，选择「显示简介」，在「共享与权限」板块确认当前用户的权限为「读与写」，如果权限不符修改后点击下方齿轮图标，选择「应用到包含的项目」即可
• 清除Xcode全局缓存：完全退出Xcode后，打开终端执行命令 rm -rf ~/Library/Developer/Xcode/DerivedData 清除缓存，重新打开项目等待索引完成后重试重命名操作
• 修复项目配置文件：关闭Xcode后，右键点击.xcodeproj文件（如果使用CocoaPods则操作.xcworkspace），选择「显示包内容」，删除xcuserdata文件夹后重新打开项目即可
• 大小写修改特殊处理：如果仅需要修改文件名大小写，可以先将文件临时重命名为其他名称（例如main.m先改为main_temp.m），再修改为目标大写名称即可；也可以先在Finder中直接修改文件名，回到Xcode右键丢失引用的原文件，选择「重新定位」关联到新名称的文件
• 处理Git冲突状态：先提交当前所有未提交的文件修改、解决存在的合并冲突后，再执行重命名操作；也可以直接在终端执行git mv 原文件名 新文件名完成重命名，Xcode会自动同步文件状态
• 备选操作方案：如果以上方法都无效，可以直接在Finder中修改文件名称，回到Xcode后右键点击原文件选择删除，删除时勾选「移除引用」不要移动到废纸篓，再将修改名称后的文件拖拽回Xcode对应目录，勾选「Copy items if needed」和对应的target即可完成替换

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