Ubuntu下Swift 4.1 Package Manager编译libavutil系统模块失败求助

我来一步步帮你排查并解决这个编译错误，问题主要出在SPM配置的规范性和系统依赖的处理上：

1. 先确认系统依赖安装到位 #

首先在Ubuntu环境下，你需要确保libavutil的开发包和pkg-config工具已经正确安装，这是SPM通过pkgConfig字段识别依赖的基础：

sudo apt-get update
sudo apt-get install libavutil-ffmpeg-dev pkg-config

安装完成后，验证pkg-config能否正常识别libavutil：

pkg-config --cflags --libs libavutil-ffmpeg

如果输出类似-I/usr/include/libavutil -lavutil的内容，说明依赖配置没问题。

2. 修正Package.swift的结构 #

你的原始Package.swift缺少targets定义，这是Swift 4.x版本SPM的必填项，而且系统模块需要明确声明为.systemModule类型。修改后的内容如下：

// swift-tools-version:4.1
import PackageDescription

let package = Package(
    name: "CAVUtil",
    targets: [
        .systemModule(
            name: "CAVUtil",
            pkgConfig: "libavutil-ffmpeg",
            providers: [
                .apt(["libavutil-ffmpeg-dev"])
            ]
        )
    ]
)

• 把swift-tools-version改为4.1，匹配你使用的Swift版本
• 添加.systemModule类型的target，明确指定pkg-config依赖名称
• providers字段是可选配置，能帮助其他用户自动安装系统依赖

3. 调整module.modulemap的位置和内容 #

SPM会自动在Sources/<TargetName>/目录下查找系统模块的modulemap文件，所以你需要调整项目目录结构为：

你的项目目录/
├── Package.swift
└── Sources/
    └── CAVUtil/
        └── module.modulemap

同时修改module.modulemap的内容，确保头文件路径正确（这里使用系统绝对路径避免路径解析问题）：

module CAVUtil [system] {
    header "/usr/include/libavutil/avutil.h"
    link "avutil"
    export *
}

4. 重新执行编译 #

完成以上步骤后，回到项目根目录执行：

swift build

应该就能正常完成编译了。

错误原因解析 #

你遇到的<unknown>:0: error: unexpected 'commands' value (expected map)是因为Swift 4.x的SPM要求必须明确声明targets，原始Package.swift仅包含name和pkgConfig字段，导致SPM解析Package结构时出错；而unable to load build file是Package解析失败后的连锁问题。

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