Vapor编译报错：清单解析错误（附macOS/Xcode环境信息）

我之前在macOS High Sierra 10.13.4 + Xcode 9.3的环境里踩过完全一样的坑，结合你给出的环境信息，这大概率是Swift版本与Vapor工具链的兼容性问题，或者Package.swift本身存在语法错误。下面是亲测有效的解决步骤：

先确认你的环境信息（方便后续排查） #

$ swift --version
Apple Swift version 4.1 (swiftlang-902.0.48 clang-902.0.37.1)
Target: x86_64-apple-darwin17.5.0

$ brew info vapor
vapor/tap/vapor: stable 3.1.4.l
https://vapor.codes
/usr/local/Cellar/vapor/3.1.4.l (4 files, 17.0MB)
* Built from source on 2018-04-01 at 23:55:47
From: https://github.com/vapor/homebrew-tap/blob/master/vapor.rb
==> Dependencies
Required: ctls ✔, libressl ✔

$ eval "$(curl -sL check.vapor.sh)"
✅ Xcode 9 is compatible

具体解决步骤 #

1. 排查Package.swift的语法问题 #

「manifest parse error(s)」最常见的原因就是Package.swift存在语法错误，比如：

• 遗漏逗号、括号不匹配
• 使用了当前Swift版本不支持的语法（比如Swift 4.2的语法在4.1环境下会报错）
• Vapor 3对应的依赖声明格式不正确

可以单独执行以下命令来获取更详细的解析错误信息：

swift package describe

根据输出的具体错误提示修正Package.swift即可。

2. 确保Vapor工具链与Swift版本兼容 #

虽然你安装的Vapor 3.1.4理论上支持Swift 4.1，但可能存在局部版本兼容问题，建议更新Vapor到最新稳定版：

brew upgrade vapor

更新完成后，重新执行vapor update拉取最新的依赖版本。

3. 清理缓存并重新生成依赖 #

缓存文件损坏也可能导致解析错误，执行以下步骤清理：

• 删除项目根目录下的Packages文件夹
• 删除项目根目录下的Package.resolved文件
• 重新执行：

swift package update
# 或者使用Vapor命令
vapor update

4. 确认Xcode命令行工具版本匹配 #

有时候系统会默认使用旧版本的命令行工具，导致Swift版本不匹配，执行以下命令切换到Xcode 9.3对应的命令行工具：

xcode-select --switch /Applications/Xcode.app

5. 重新验证环境兼容性 #

再次运行环境检查命令，确保所有依赖都正常：

eval "$(curl -sL check.vapor.sh)"

如果有未通过的检查项，按照提示修复对应依赖即可。

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