首先，您必须了解Podfile。锁就是然后明白什么是Manifest。锁是什么，用在什么地方。

Podfile包含您拥有的每个依赖项的(乐观或精确)版本。锁文件只保存精确的版本。

一旦你安装了pod，所有的pod都会被下载/安装到/pods目录中。你可能想承认，也可能不想。这取决于你的团队。你的团队不能决定他们是否应该提交Podfile。锁不锁。这样团队中的每个开发人员都可以确保他们得到完全相同的版本。

假设您下载了团队的代码。在项目的根目录中，只有Podfile和Podfile。锁，Pods目录没有被提交。 然后执行pod install来创建Pods目录。每个pod的版本快照应该与Podfile.lock中所有pod的版本相匹配。 CocoaPods有一个安全检查，以确保匹配的版本

这就是舱单。锁开始发挥作用。清单。Lock是本地机器创建的锁。它必须与Podfile匹配。在你的repo中，由最后一次提交(导致你的pods的变化)生成的锁。如果不匹配，那就有问题了。

关于清单的文件。锁文件为:

  #     Manifest.lock: A file contained in the Pods folder that keeps track of
  #     the pods installed in the local machine. This files is used once the
  #     exact versions of the Pods has been computed to detect if that version
  #     is already installed. This file is not intended to be kept under source
  #     control and is a copy of the Podfile.lock.

老实说，我只能想到一种情况Manifest。锁和Podfile。锁将不同步:

我的意思是如果你从main分支中拉，你会得到main的Podfile和lock file。如果你对Podfile进行了更改，然后运行pod install，那么你将更新Podfile。锁定和清单。锁定并保持它们同步。没有问题

这样是否可以:

您和您的团队不提交/Pods目录 您的Podfile或Podfile中存在合并冲突。锁上，但没有意识到。或者你没有同时提交Podfile和Podfile.lock 假设Xcode不处理Podfile和Podfile。锁定后，您的项目自然可以成功构建。 然而，如果你去检查你的目标的构建阶段，你会看到以下内容

这里记录了该脚本

#     Adds a shell script build phase responsible for checking if the Pods
#     locked in the Pods/Manifest.lock file are in sync with the Pods defined
#     in the Podfile.lock.
#     
#     @note   The build phase is appended to the front because to fail fast.
#     
#     @return [void]

这些行所做的是:执行一个diff并确保您的Manifest。例如，所有已安装pod版本的本地快照都等于Podfile。锁定，即您的回购当前所有已安装pod版本的快照。

修复可能超级简单，只要确保你的Podfile是你想要的。然后运行pod install。你也不小心改变了你的清单。锁在你的/Pods目录中(或者如前所述，可能只提交锁文件而不提交Podfile，反之亦然)。删除/Pods目录不会造成伤害。然后再做一个吊舱安装。不要更新吊舱，除非你想这么做。

只要确保你没有删除Podfile。锁定，否则如果你做pod安装，那么它将更新所有依赖到最新版本。

这段关于锁文件的视频也很有帮助，CocoaPods文档介绍了锁文件在pod安装和pod更新中的不同用法，最后详细介绍了如何使用所有这些逻辑 这个关于校验和的艺术博客。值得注意的是，单个空格将创建一个新的校验和，并可能使内容不同步。

我们也遇到了同样的问题，我们团队中有人打开了Podfile。锁在Visual Studio Code中，保存它，编辑器已经删除了文件末尾的CR(回车)。重新引入“CR”解决了这个问题。 所以一定要运行这个命令来找出这些文件不同的原因。

diff "${PODS_ROOT}/../../Podfile.lock" "${PODS_ROOT}/Manifest.lock"

我也犯了同样的错误。首先我更新cocoapods使用

sudo gem install cocoapods

然后安装Pod使用Pod安装命令为我工作。

我在最新的ComponentKit 0.14上也有同样的问题。 原因是PODS_ROOT没有设置，我发现解决方案是添加一行到ComponentKit。xcconfig:

#include "../Pods/Target Support Files/Pods-ComponentKit/Pods-ComponentKit.debug.xcconfig"

对我来说，问题是我通过复制一个现有的目标在我的应用程序中创建了一个新目标，但忘记将目标添加到Podfile中。由于某种原因，克隆的目标工作了几天没有问题，但过了一段时间后，它无法通过这个错误构建。我必须在Podfile中为我克隆的项目目标创建一个新的目标条目，然后运行pod install。

在项目中检查pod可能没有被推送到Git。所以很明显compile将会崩溃，因为它无法找到Pods目录

 diff "${PODS_ROOT}/../../Podfile.lock" "${PODS_ROOT}/Manifest.lock" > /dev/null

我通过在终端中导航到我的项目目录后发出pod install来解决这个问题。

事实上，我有一个错误无法找到pod命令，这意味着cocoapods没有安装。这是通过gem install cocoapods来修复的。如果遇到依赖项错误，只需安装报告丢失的每个命令。在我的情况下，我必须更新Ruby，在cocoapods正确安装后，我可以使用命令舱安装。

PS.如果你有pod目录，尝试pod更新。也许你的库需要更新。