Xcode 9:iCloud同步后如何重新关联项目与工作区?
重新关联iCloud中Xcode工作区与项目文件的解决步骤
我完全懂你这种闹心的情况——iCloud同步偶尔就是会抽风,把Xcode工作区和项目的关联搞丢,但好在所有文件都完好同步着,咱们只要把关联重新建立起来就行,跟着下面的步骤操作:
方法一:手动修复工作区配置文件
- 先彻底关闭Xcode(包括后台进程,确保没有文件被锁定)
- 找到你的
.xcworkspace文件,右键选择「显示包内容」 - 在弹出的文件夹里找到
contents.xcworkspacedata文件,用文本编辑器(比如TextEdit)打开它 - 检查里面的内容,正常情况下应该有类似这样的行:
如果这行缺失或者路径错误,就手动添加/修正它(如果项目和工作区在同一文件夹下,直接用<FileRef location="group:你的项目名称.xcodeproj"/>group:项目文件名.xcodeproj就行) - 保存文件,关闭文本编辑器,重新打开工作区,项目应该就能正常显示了
方法二:在Xcode中重新添加项目
如果上面的方法没生效,试试这个更直观的操作:
- 打开你的
.xcworkspace文件(此时应该只显示Pods项目) - 点击Xcode顶部菜单栏的「File」→「Add Files to "你的工作区名称"」
- 在弹窗里找到你的
.xcodeproj项目文件,不要勾选「Copy items if needed」(因为文件已经在iCloud同步目录里了,复制会造成重复) - 点击「Add」,然后按下
Cmd+S保存工作区,现在项目应该就出现在导航栏里了
额外排查步骤
如果还是不行,可能是Xcode缓存的问题:
- 关闭Xcode,打开终端,输入以下命令清除DerivedData缓存:
rm -rf ~/Library/Developer/Xcode/DerivedData - 回车执行后,重启Xcode再打开工作区试试
小提醒
以后尽量避免在两台设备同时打开同一个iCloud里的Xcode项目,同步冲突很容易导致这类关联丢失;操作前最好备份一下.xcworkspace文件,以防万一。
内容的提问来源于stack exchange,提问作者pakpe
相关产品推荐
相关产品推荐

