引言：Arch Linux 软件包管理的核心
Arch Linux 以其极简主义、灵活性和强大的包管理系统而闻名。作为 Arch 用户，掌握 PKGBUILD 编写和 AUR（Arch User Repository）提交不仅是进阶技能，更是深度定制系统和贡献社区的必经之路。本文将从零基础出发，详细讲解 PKGBUILD 的编写、软件包构建、测试以及 AUR 提交的全流程。我们将通过实际例子，逐步拆解每个环节，确保你能够独立处理从简单脚本到复杂软件包的开发。
PKGBUILD 是 Arch Linux 软件包构建的核心脚本，它是一个 Bash 脚本，定义了软件包的元数据、源代码获取、编译和安装步骤。AUR 则是社区驱动的仓库，用户可以上传自己的 PKGBUILD，让其他用户轻松安装非官方软件。通过本指南，你将学会如何从零创建一个完整的软件包，并将其贡献给 Arch 社区。
第一部分：Arch Linux 软件包基础
什么是 PKGBUILD？
PKGBUILD 是一个纯文本文件，通常位于一个名为
pkgname/
的目录中。它使用 Bash 语法，定义了构建软件包所需的所有信息。Arch 使用
makepkg
工具来解析 PKGBUILD 并生成
.pkg.tar.zst
格式的包文件。PKGBUILD 的结构简单却强大，包括变量、函数和指令。
为什么学习 PKGBUILD？
自定义软件
：安装 Arch 官方仓库中没有的软件。
优化构建
：针对你的硬件启用特定优化（如 AVX2 指令集）。
社区贡献
：通过 AUR 帮助他人，积累声誉。
学习价值
：理解软件构建过程，提升 Linux 系统管理技能。
先决条件
一台运行 Arch Linux 的机器（或衍生版如 Manjaro）。
基本命令行知识（cd、ls、make 等）。
安装必要工具：
sudo pacman -S base-devel git
。
base-devel
包含 gcc、make、fakeroot 等构建工具。
网络访问，用于下载源代码。
软件包类型
二进制包
：直接安装预编译文件（如官方仓库的包）。
源代码包
：从源代码构建（PKGBUILD 的主要用途）。
AUR 包
：社区维护，需手动构建或使用 AUR 助手（如 yay 或 paru）。
第二部分：PKGBUILD 的详细结构与编写
PKGBUILD 是一个 Bash 脚本，以
pkgname
开头，包含多个变量和函数。让我们逐一分解其核心组件。每个部分都有清晰的主题句，后跟解释和例子。
1. 基本变量：定义软件包元数据
PKGBUILD 的开头定义了软件包的核心信息。这些变量是必需的，且必须使用大写。
pkgname
：软件包名称，必须小写、无空格、无特殊字符（下划线除外）。例如：
pkgname=myapp
。
pkgver
：软件版本号，通常与上游版本一致。例如：
pkgver=1.2.3
。
pkgrel
：包发布号，用于区分同一版本的不同构建（如修复 bug）。从 1 开始，每次更新 PKGBUILD 时递增。例如：
pkgrel=1
。
pkgdesc
：简短描述，不超过 80 字符。例如：
pkgdesc=”A simple text editor”
。
arch
：支持的架构，通常是
(‘x86_64’)
或
(‘any’)
（跨平台）。例如：
arch=(‘x86_64’)
。
url
：上游项目主页。例如：
url=”https://github.com/example/myapp”
。
license
：软件许可证，必须是 SPDX 许可证标识符。例如：
license=(‘GPL-3.0-or-later’)
。
depends
：运行时依赖，安装包时必须存在。例如：
depends=(‘glibc’ ‘gcc-libs’)
。
makedepends
：构建时依赖，仅在编译时需要。例如：
makedepends=(‘cmake’ ‘make’)
。
checkdepends
：测试时依赖（可选）。例如：
checkdepends=(‘gtest’)
。
optdepends
：可选依赖，提供额外功能。例如：
optdepends=(‘python: for scripting support’)
。
完整基本变量例子
（一个简单 C 程序的 PKGBUILD 开头）：
# Maintainer: Your Name
pkgname=simple-editor
pkgver=1.0.0
pkgrel=1
pkgdesc=”A minimal text editor written in C”
arch=(‘x86_64’)
url=”https://github.com/example/simple-editor”
license=(‘MIT’)
depends=(‘glibc’)
makedepends=(‘make’ ‘gcc’)
2. source 数组：获取源代码
source
数组定义了构建所需的文件，通常是从 URL 下载的源代码压缩包。每个元素是一个文件名或 URL。
基本用法
：使用 HTTP/HTTPS 或 FTP URL。文件会自动下载到当前目录。
本地文件
：如果源代码在本地，使用
file://
前缀。
Git 仓库
：使用
git+https://
协议，支持分支或标签。
校验和
：每个 source 条目通常对应一个
.sig
或校验和文件，用于验证完整性。
例子
：下载一个 tarball。
source=(“https://github.com/example/simple-editor/archive/refs/tags/v${pkgver}.tar.gz”)
下载后，文件名为
v1.0.0.tar.gz
。
高级例子
：使用 Git 仓库。
source=(“git+https://github.com/example/simple-editor.git#tag=v${pkgver}”)
这会克隆仓库并检出指定标签。
3. sha256sums：校验和验证
为了安全，PKGBUILD 必须包含源文件的 SHA256 校验和。
makepkg
会自动计算并比较。
生成校验和
：使用
sha256sums
数组，顺序与
source
一一对应。
如果未知
：使用
SKIP
（不推荐，仅用于开发）。
生成工具
：
updpkgsums
脚本（从 aur 助手安装）可自动更新。
例子
：
sha256sums=(‘e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855’)
如果 source 有多个条目：
sha256sums=(‘sum1’ ‘sum2’)
生成校验和的步骤
：
下载源文件：
wget https://…/v1.0.0.tar.gz
。
计算：
sha256sum v1.0.0.tar.gz
。
复制输出到 PKGBUILD。
4. 函数：构建过程的核心
PKGBUILD 使用可选函数来定制构建步骤。这些函数按顺序执行，如果省略，
makepkg
会使用默认行为。
prepare()
：准备源代码，如打补丁或解压。默认已解压 tarball。
例子：应用补丁。
prepare() {
cd “${srcdir}/simple-editor-${pkgver}”
patch -p1 < "${srcdir}/fix-bug.patch"
}
build()
：编译源代码。这是最重要的函数。
例子：使用 Makefile。
build() {
cd "${srcdir}/simple-editor-${pkgver}"
make
}
对于 CMake 项目：
build() {
cd "${srcdir}/project-${pkgver}"
cmake -B build -DCMAKE_INSTALL_PREFIX=/usr
cmake --build build
}
check()
：运行测试（可选，但推荐）。
例子：
check() {
cd "${srcdir}/simple-editor-${pkgver}"
make test
}
package()
：安装文件到 fakeroot 环境，生成包。
例子：
package() {
cd "${srcdir}/simple-editor-${pkgver}"
make DESTDIR="${pkgdir}" install
# 安装许可证
install -Dm644 LICENSE "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"
}
5. 完整 PKGBUILD 例子：构建一个简单 C 程序
假设我们有一个名为 “hello-world” 的简单 C 程序，源代码在 GitHub 上。
完整 PKGBUILD
：
# Maintainer: Your Name
pkgname=hello-world
pkgver=1.0.0
pkgrel=1
pkgdesc=”A simple Hello World program”
arch=(‘x86_64’)
url=”https://github.com/example/hello-world”
license=(‘MIT’)
depends=(‘glibc’)
makedepends=(‘make’ ‘gcc’)
source=(“https://github.com/example/hello-world/archive/refs/tags/v${pkgver}.tar.gz”)
sha256sums=(‘e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855’) # 示例哈希，实际需替换
build() {
cd “${srcdir}/hello-world-${pkgver}”
make
}
package() {
cd “${srcdir}/hello-world-${pkgver}”
make DESTDIR=”${pkgdir}” install
install -Dm644 LICENSE “${pkgdir}/usr/share/licenses/${pkgname}/LICENSE”
}
构建步骤
：
创建目录：
mkdir hello-world && cd hello-world
。
保存 PKGBUILD。
运行：
makepkg -si
（-s 安装依赖，-i 安装包）。
如果成功，生成
hello-world-1.0.0-1-x86_64.pkg.tar.zst
。
6. 高级 PKGBUILD 技巧
变量扩展
：使用
${pkgver}
避免硬编码。
条件构建
：使用 if 语句，如
if [ “$CARCH” = “x86_64” ]; then … fi
。
补丁管理
：将补丁文件放入 source 数组，如
source+=(“fix.patch”)
。
版本控制
：使用
pkgver()
函数动态生成版本（如从 Git 仓库）。
例子：
pkgver() {
cd “${srcdir}/project”
printf “%s.%s” “$(git describe –tags –abbrev=0)” “$(git rev-parse –short HEAD)”
}
调试
：使用
makepkg -e
（不提取源代码）或
makepkg -o
（仅下载）。
第三部分：构建、测试和调试软件包
1. 使用 makepkg 构建
makepkg
是 Arch 的构建工具，它解析 PKGBUILD、下载源代码、构建并打包。
常用选项
：
-s
：安装依赖（通过 pacman）。
-i
：安装包到系统。
-c
：清理构建文件。
-r
：移除构建依赖。
-A
：忽略架构检查。
-f
：强制重建。
完整构建流程
：
进入 PKGBUILD 目录。
运行
makepkg -s
。
如果依赖缺失，pacman 会提示安装。
构建日志在
pkg/
和
src/
目录中。
例子：构建上述 hello-world
：
cd hello-world
makepkg -si
输出：
==> Starting build()…
等日志，最终安装包。
2. 测试软件包
构建后，测试安装和功能：
安装
：
sudo pacman -U hello-world-*.pkg.tar.zst
。
验证
：运行软件，如
hello-world
。
卸载
：
sudo pacman -R hello-world
。
检查依赖
：
pacman -Qi hello-world
查看元数据。
运行测试
：在
check()
函数中添加单元测试，如
make test
。
3. 常见错误与调试
依赖缺失
：错误如
make: command not found
。解决：添加到
makedepends
。
哈希不匹配
：
sha256sums
错误。解决：重新计算并更新。
权限问题
：使用
fakeroot
（makepkg 自动处理）。
网络问题
：源 URL 无效。测试：
wget
手动下载。
编译失败
：检查
build()
中的路径（使用
${srcdir}
）。
调试技巧
：
运行
makepkg -e
编辑源代码而不重新提取。
使用
set -x
在函数开头打印执行步骤。
查看日志：
tail -f makepkg.log
。
例子：调试一个 CMake 项目
：
如果 CMake 失败，添加：
build() {
cd “${srcdir}/project-${pkgver}”
cmake -B build -DCMAKE_BUILD_TYPE=Debug
cmake –build build –verbose # 显示详细输出
}
4. 最佳实践
保持 PKGBUILD 简洁
：避免不必要的函数。
版本更新
：监控上游，更新
pkgver
和
pkgrel
。
安全性
：始终验证源代码，避免使用
SKIP
。
文档
：在 PKGBUILD 顶部添加注释，解释自定义部分。
多版本支持
：使用
provides
和
conflicts
变量处理冲突。
第四部分：AUR 提交流程
AUR 是 Arch 用户的宝库，提交 PKGBUILD 让他人受益。AUR 使用 Git 仓库管理，每个包是一个独立仓库。
1. 准备 AUR 包
命名规范
：包名应描述性强，如
python-requests
。避免与官方包冲突。
AUR 特定变量
：
_pkgbase
：基础名（用于 git 仓库）。
_gitcommit
：Git 提交哈希（可选）。
.SRCINFO
：这是 AUR 的元数据文件，由
makepkg –printsrcinfo
生成。必须包含在仓库中。
PKGBUILD 必须
：包含
pkgbase
（如果多包）和完整依赖。
例子：准备 AUR 仓库
：
创建仓库：
git clone ssh://git@aur.archlinux.org/hello-world.git
（需 AUR 账户）。
将 PKGBUILD 和 .SRCINFO 放入。
生成 .SRCINFO：
makepkg –printsrcinfo > .SRCINFO
。
2. 注册 AUR 账户
访问
https://aur.archlinux.org/，注册账户。
设置 SSH 密钥：生成
ssh-keygen -t ed25519
，上传公钥到 AUR 账户设置。
验证邮箱。
3. 提交步骤
克隆仓库
：
git clone ssh://git@aur.archlinux.org/pkgname.git
。
添加文件
：
PKGBUILD
.SRCINFO
可选：install 文件（post-install 脚本）、.desktop 文件等。
提交
：
git add PKGBUILD .SRCINFO
git commit -m “Add hello-world 1.0.0”
git push origin master
更新
：修改后，递增
pkgrel
，重新生成 .SRCINFO，提交并推送。
删除
：使用
git rm
并推送（需理由）。
完整提交例子
：
# 在仓库目录
makepkg –printsrcinfo > .SRCINFO
git add PKGBUILD .SRCINFO
git commit -m “Initial commit: hello-world 1.0.0-1”
git push
4. AUR 审核与维护
审核
：AUR 是无人审核的，但用户会报告问题。监控评论。
常见拒绝原因
：
依赖错误或缺失。
违反命名规范。
安全问题（如未验证源代码）。
使用 AUR 助手测试
：安装
yay
或
paru
，然后
yay -S hello-world
测试构建。
维护提示
：
响应用户反馈，快速修复。
使用
namcap
工具检查包：
namcap PKGBUILD
或
namcap pkg.tar.zst
（检测依赖、权限问题）。
多包 PKGBUILD：使用
pkgbase
和数组，如
pkgname=(pkg1 pkg2)
。
版本更新脚本：使用
git pull
和
updpkgsums
自动化。
5. 高级 AUR 技巧
VCS 包
：使用
-git
后缀，如
pkgname=hello-world-git
，源为 Git 仓库，
pkgver()
动态版本。
Split 包
：一个 PKGBUILD 构建多个包。
例子：
pkgbase=project
pkgname=(project-main project-docs)
…
package_project-main() { … }
package_project-docs() { … }
AURWeb 交互
：通过 Web 界面查看统计、投票。
法律与道德
：仅提交合法软件，避免专有软件或违反 GPL 的包。
6. 提交后的流程
等待
：立即可用，但用户需手动构建。
推广
：在 Arch 论坛或 Reddit 分享。
监控
：使用
aurweb
API 检查状态。
结论：从新手到专家
通过本指南，你已掌握 PKGBUILD 编写的核心，从基本变量到复杂构建函数，再到 AUR 提交的 Git 工作流。实践是关键：从简单包开始，如 hello-world，逐步挑战复杂项目如自定义内核模块。记住，Arch 社区强调“KISS”（Keep It Simple, Stupid），保持你的 PKGBUILD 简洁高效。
如果遇到问题，参考 Arch Wiki（wiki.archlinux.org）的 PKGBUILD 页面，或使用
man PKGBUILD
和
man makepkg
。贡献 AUR 不仅帮助他人，也深化你对 Linux 生态的理解。开始你的第一个包吧！如果有具体项目需求，欢迎提供更多细节以获取针对性指导。