1. 为什么要在 Windows 上折腾 arm64 的 deb 包很多人第一次听到在 Windows 上打 arm64 的 deb 包这个需求第一反应是这不是自找麻烦吗直接在板子上编译不就完了。我一开始也是这么想的直到手上那块 RK3588 开发板只有 4GB 内存编译一个中等规模的 C 项目链接阶段直接被 OOM Killer 干掉swap 开到 8GB 还是卡到怀疑人生。后来换成树莓派 58GB 版本稍微好点但编译 Qt 这种体量的东西一个下午就没了板子还烫得能煎蛋。所以真实场景是这样的你手上有一台性能不错的 Windows 台式机或者笔记本32GB 内存、多核 CPU平时写代码、跑 IDE 都很爽但你的目标运行环境是 arm64 架构的 Linux 板子——可能是树莓派、RK 系列、全志系列也可能是国产化平台上的麒麟系统。你希望在这台 Windows 机器上把编译这件事干完最后只把产物拷到板子上装一下就行。这就是交叉编译最朴素的动机用强机器编译用弱机器运行。那为什么是 deb 包而不是直接 tar 包解压因为 deb 包解决的不只是打包这一个问题。它帮你管理安装路径、依赖声明、安装前后的脚本钩子、版本升级和卸载。你在板子上dpkg -i一行命令它自动把文件放到/usr/bin、/usr/lib、/etc这些标准位置还会检查依赖是否满足。如果你只是 tar 包解压这些事全得手动做装十个软件就有十套不同的目录结构维护成本极高。尤其是当你要给多块板子、多个同事部署同一套东西时deb 包的价值就体现出来了。而 WSL 在这里扮演的角色是一个几乎零成本的 Linux 编译宿主。你不需要装双系统不需要开虚拟机虚拟机还要分配内存、配网络、传文件WSL2 直接在你的 Windows 里跑一个真实的 Linux 内核文件系统互通网络互通还能调用 Windows 的图形界面。你可以在 Windows 上用 VS Code 写代码在 WSL 里编译产物直接落在 Windows 磁盘上再通过 scp 或者 U 盘拷到板子。整条链路非常顺。不过这里有个关键点必须先说清楚WSL 默认是 x86_64 架构的。你uname -m看到的是x86_64不是aarch64。所以你不能指望在 WSL 里直接gcc一下就产出 arm64 的二进制。你需要的是交叉编译工具链——一套运行在 x86_64 上、但生成 arm64 代码的编译器。这是整件事的技术核心也是最多人卡住的地方。提示交叉编译和在 WSL 里装 qemu 模拟 arm64 再编译是两条完全不同的路。qemu 模拟能跑通但速度慢到让你怀疑人生编译大型项目基本不可用。交叉编译才是正解qemu 只适合做最后的验证。2. 交叉编译工具链的选型与 WSL 环境准备2.1 三种工具链来源的取舍在 Linux 上做 arm64 交叉编译工具链的来源主要有三类我逐个说一下实际体验。第一类是发行版官方仓库里的包比如 Ubuntu 上的gcc-aarch64-linux-gnu和g-aarch64-linux-gnu。这是最省事的方式apt install一行搞定版本和系统匹配不会出现奇怪的链接错误。缺点是版本可能偏旧比如 Ubuntu 22.04 上默认是 GCC 11如果你需要 GCC 13 的新特性就不够用。但对于绝大多数项目GCC 11 完全够用。第二类是 Linaro 或者 ARM 官方发布的预编译工具链。这些工具链针对 ARM 平台做了优化版本更新支持的特性更全。下载下来解压把bin目录加到 PATH 里就能用。缺点是体积大动辄几百 MB 到 1GB而且有时候和宿主系统的 glibc 版本会有微妙的兼容问题。第三类是用 Yocto、Buildroot 或者 crosstool-NG 自己构建工具链。这种方式最灵活可以精确控制 glibc 版本、内核头文件版本、编译选项适合产品化场景。但构建一次工具链可能要几个小时而且配置复杂不适合快速验证。我的建议是先用发行版仓库的包把流程跑通确认整个链路没问题再根据实际需求决定要不要换更专业的工具链。很多人一上来就折腾 Linaro 工具链结果卡在环境变量或者库路径上连个 hello world 都没编译出来信心就没了。2.2 WSL 环境的几个关键配置WSL 的安装本身现在很简单wsl --install就行。但有几个配置点直接影响你后续的编译体验我踩过坑这里说清楚。首先是 WSL 的版本。必须用 WSL2不能用 WSL1。WSL1 是系统调用翻译层很多编译工具的行为不正常尤其是涉及fork、mmap、文件锁的操作。wsl --set-version Ubuntu-22.04 2可以切换。确认版本用wsl -l -v看到 VERSION 是 2 就对了。其次是内存和 CPU 分配。WSL2 默认会占用宿主机最多 50% 的内存在较新的版本里是 50% 或者 8GB 取小值。如果你宿主机是 32GBWSL 最多能用 16GB编译一般够用。但如果你的项目特别大可以在C:\Users\你的用户名\.wslconfig里手动配置[wsl2] memory24GB processors12 swap8GB改完wsl --shutdown重启生效。注意processors不要设成宿主机的全部核心数留一两个给 Windows 本身否则编译时整个系统会卡到没法用。第三是文件系统的选择。这是个容易被忽略但影响巨大的点。WSL 里访问 Windows 磁盘/mnt/c/...的性能很差因为跨了文件系统边界。如果你把源码放在/mnt/c/Users/xxx/project下编译会比放在 WSL 自己的文件系统~/project里慢好几倍。我实测过一个中型项目放在/mnt/c下编译要 8 分钟放在~下只要 2 分半。所以源码一定要放在 WSL 的原生文件系统里编译完再把产物拷出去。但这里有个矛盾你可能习惯用 Windows 上的编辑器打开源码。解决办法是用 VS Code 的 Remote-WSL 插件它让你在 Windows 的 VS Code 界面里直接编辑 WSL 里的文件体验和本地编辑几乎一样但文件实际在 WSL 文件系统里。这个组合我用了一年多非常顺。2.3 安装交叉编译工具链的完整命令以 Ubuntu 22.04 为例装 arm64 交叉编译工具链sudo apt update sudo apt install -y gcc-aarch64-linux-gnu g-aarch64-linux-gnu \ binutils-aarch64-linux-gnu \ cmake make ninja-build pkg-config装完之后验证一下aarch64-linux-gnu-gcc --version aarch64-linux-gnu-gcc -dumpmachine第二条命令应该输出aarch64-linux-gnu说明工具链的目标架构是对的。然后写个 hello world 测试echo int main(){return 0;} test.c aarch64-linux-gnu-gcc test.c -o test_arm64 file test_arm64file命令应该显示ELF 64-bit LSB executable, ARM aarch64。如果显示的是 x86_64说明你用的还是本机 gcc不是交叉编译器检查一下命令名是不是写错了。注意交叉编译出来的二进制不能在 WSL 里直接运行架构不匹配会报cannot execute binary file: Exec format error。这是正常的不要以为编译失败了。要验证运行得用 qemu-user 或者直接拷到板子上。3. 从源码到 deb打包流程的每一步拆解3.1 先搞清楚 deb 包的目录结构约定很多人打 deb 包失败根本原因是不了解 deb 包的内部结构约定。一个 deb 包本质上是一个 ar 归档里面包含control.tar.gz元数据和脚本和data.tar.gz实际文件。但你在制作时不需要手动构造这些用dpkg-deb或者dh_make这类工具就行。关键是data.tar.gz里的目录结构。deb 包安装时是把data目录下的内容原样解压到根目录/。所以如果你想让程序装到/usr/bin/myapp你的打包目录里就得有usr/bin/myapp这个路径。这个根目录镜像的概念是理解 deb 打包的核心。一个典型的打包工作目录长这样myapp-1.0/ ├── DEBIAN/ │ ├── control │ ├── postinst │ └── prerm └── usr/ ├── bin/ │ └── myapp ├── lib/ │ └── myapp/ │ └── libhelper.so └── share/ └── myapp/ └── config.jsonDEBIAN目录全大写是元数据目录不会被打进data.tar.gz而是单独处理。其他目录就是实际安装的文件。这个结构你手动建也行用工具生成也行但必须符合这个约定。3.2 control 文件deb 包的身份证DEBIAN/control是 deb 包最重要的文件它决定了包名、版本、架构、依赖关系。一个最小可用的 control 文件Package: myapp Version: 1.0.0 Architecture: arm64 Maintainer: yourname youremail.com Depends: libc6 ( 2.31), libstdc6 Description: A demo application for arm64 This is a longer description that can span multiple lines. Each line after the first must start with a space.这里有几个坑必须说。Architecture 字段交叉编译时这里必须写arm64不能写amd64或者all。如果你写错了dpkg -i在板子上会直接拒绝安装报架构不匹配。all只适用于纯脚本、纯数据这种和架构无关的包。Depends 字段这是依赖声明格式是包名 (版本约束)多个依赖用逗号分隔。这里最容易出问题的是版本约束写得太死或者太松。写太死板子上版本稍微低一点就装不上写太松运行时缺库崩溃。我的经验是对于系统基础库libc6、libstdc6给一个最低版本约束就行不要写上限。对于你自己依赖的第三方库如果板子上可能没有要么在 Depends 里声明要么干脆静态链接进去。Description 字段第一行是简短描述后面可以跟多行详细描述但每一行续行都必须以空格开头。这个格式很严格少一个空格就会解析失败。我见过有人在这里栽跟头dpkg-deb --build直接报 control 文件格式错误。3.3 用 CMake 工具链文件驱动交叉编译如果你的项目用 CMake交叉编译的关键是提供一个 toolchain file。这个文件告诉 CMake 用哪个编译器、目标系统是什么、去哪里找库。一个实用的arm64-toolchain.cmakeset(CMAKE_SYSTEM_NAME Linux) set(CMAKE_SYSTEM_PROCESSOR aarch64) set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc) set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g) set(CMAKE_FIND_ROOT_PATH /usr/aarch64-linux-gnu) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)CMAKE_FIND_ROOT_PATH_MODE_*这几行非常关键。它们控制 CMake 在找程序、库、头文件时的搜索策略。PROGRAM设为NEVER表示找可执行程序比如构建工具时用宿主系统的不要用目标系统的LIBRARY、INCLUDE、PACKAGE设为ONLY表示找库和头文件时只在目标根路径下找不要误用宿主系统的 x86 库。这个配置如果搞错最常见的症状是链接时报skipping incompatible /usr/lib/x86_64-linux-gnu/libxxx.so意思就是 CMake 找到了 x86 的库架构不匹配。使用方式mkdir build cd build cmake -DCMAKE_TOOLCHAIN_FILE../arm64-toolchain.cmake \ -DCMAKE_INSTALL_PREFIX/usr \ -DCMAKE_BUILD_TYPERelease .. make -j$(nproc) make DESTDIR../pkgroot installDESTDIR是打包的关键。它让make install把文件装到一个临时根目录而不是真的装到/usr。这样pkgroot目录就变成了我们前面说的根目录镜像直接拿它去打包就行。3.4 处理第三方依赖交叉编译最烦人的部分纯自己写的代码交叉编译很简单麻烦的是依赖第三方库。比如你的程序用了 OpenSSL、zlib、libcurl这些库在 WSL 里装的是 x86 版本交叉编译时链接会失败。解决办法有三种。第一种是找这些库的 arm64 版本用dpkg -i装到 WSL 里需要开 multiarch但这种方式容易把系统搞乱。第二种是用apt-get download下载 arm64 的 deb 包解压到某个目录然后在 toolchain file 里把CMAKE_FIND_ROOT_PATH指向这个目录。第三种是自己交叉编译这些依赖最干净但最费时间。我一般用第二种具体操作# 添加 arm64 架构支持 sudo dpkg --add-architecture arm64 # 但不要直接 apt install会污染系统 # 改用下载方式 apt-get download libssl-dev:arm64 dpkg-deb -x libssl-dev_*.deb /opt/arm64-sysroot然后把/opt/arm64-sysroot加到 toolchain file 的CMAKE_FIND_ROOT_PATH里。这样 CMake 就能找到 arm64 的头文件和库而不会误用系统的 x86 版本。提示dpkg --add-architecture arm64之后如果你不小心apt install了某个库可能会把系统里的 x86 版本替换掉导致 WSL 本身出问题。所以下载依赖时一定要用apt-get download而不是apt install或者用apt install 包名:arm64明确指定架构。4. 打包、传输与板子上的安装验证4.1 用 dpkg-deb 构建 deb 包假设你已经通过make DESTDIR../pkgroot install得到了pkgroot目录接下来补上DEBIAN目录cd pkgroot mkdir -p DEBIAN cat DEBIAN/control EOF Package: myapp Version: 1.0.0 Architecture: arm64 Maintainer: yourname youremail.com Depends: libc6 ( 2.31), libstdc6 Description: A demo application for arm64 Built with cross toolchain on WSL. EOF然后构建cd .. dpkg-deb --build --root-owner-group pkgroot myapp_1.0.0_arm64.deb--root-owner-group这个参数很重要。它把所有文件的属主和属组都设成 root避免把 WSL 里的用户名比如 uid 1000打进包里。如果不加这个参数装到板子上后文件属主会变成一个不存在的 uid虽然大多数情况不影响运行但看起来很不专业而且某些对权限敏感的程序会出问题。构建完成后验证一下包的内容dpkg-deb -I myapp_1.0.0_arm64.deb # 查看 control 信息 dpkg-deb -c myapp_1.0.0_arm64.deb # 查看文件列表-I输出里要确认 Architecture 是 arm64-c输出里要确认文件路径和权限符合预期。4.2 安装脚本postinst 和 prerm 的正确写法很多程序装完需要做一些初始化比如创建用户、建目录、注册服务。这些通过DEBIAN/postinst脚本完成。一个典型的 postinst#!/bin/bash set -e case $1 in configure) # 创建运行用户如果不存在 if ! id -u myapp /dev/null 21; then useradd --system --no-create-home --shell /usr/sbin/nologin myapp fi # 创建数据目录 mkdir -p /var/lib/myapp chown myapp:myapp /var/lib/myapp # 重载 systemd systemctl daemon-reload || true ;; abort-upgrade|abort-remove|abort-deconfigure) ;; *) echo postinst called with unknown argument: $1 2 exit 1 ;; esac exit 0几个要点。第一set -e让脚本遇到错误立即退出避免半途而废留下烂摊子。第二case $1是 deb 脚本的标准模式$1是操作类型configure是最常见的。第三脚本必须有可执行权限chmod 755 DEBIAN/postinst否则 dpkg 会报权限错误。第四脚本里调用 systemctl 要加|| true因为有些环境比如容器里没有 systemd不加会导致安装失败。prerm是卸载前执行的脚本一般用来停服务#!/bin/bash set -e case $1 in remove|deconfigure) systemctl stop myapp.service || true systemctl disable myapp.service || true ;; esac exit 0注意prerm里不要删用户和目录那是postrm的活。卸载时保留数据是更安全的做法万一用户是误卸载重装后数据还在。4.3 把 deb 包传到板子上传输方式取决于你的板子怎么连的。如果是网线或者 WiFi 连着同一个局域网最简单的是 scpscp myapp_1.0.0_arm64.deb pi192.168.1.100:/tmp/如果板子没联网用 U 盘拷也行。还有一种情况是板子通过串口连着那就得用sz/rz或者adb push如果板子支持 adb。我一般用 scp因为快且可靠。传过去之后在板子上安装sudo dpkg -i /tmp/myapp_1.0.0_arm64.deb如果依赖不满足会报dependency problems prevent configuration。这时候有两种处理方式。如果板子能联网直接sudo apt-get install -f自动修复依赖。如果不能联网就得手动把缺失的依赖 deb 包也拷过去按顺序安装。注意dpkg -i报依赖错误时包其实已经解压了只是没配置。这时候程序文件已经在/usr/bin下了但状态是iUunpacked but not configured。你可以用dpkg -l | grep myapp看状态。修复依赖后sudo dpkg --configure -a会重新配置所有未配置的包。4.4 验证安装结果装完之后验证几个点。第一dpkg -l myapp看状态是不是iiinstalled and configured。第二which myapp看可执行文件在不在 PATH 里。第三直接运行myapp --version看能不能跑起来。第四如果注册了 systemd 服务systemctl status myapp看服务状态。如果运行时报No such file or directory但文件明明存在八成是动态链接器路径不对。用readelf -l myapp | grep interpreter看一下解释器路径正常应该是/lib/ld-linux-aarch64.so.1。如果显示的是别的路径说明工具链的 sysroot 配置有问题需要重新编译。如果报error while loading shared libraries: libxxx.so.x: cannot open shared object file说明缺运行库。用aarch64-linux-gnu-objdump -p myapp | grep NEEDED看依赖了哪些库然后确认板子上有没有这些库。缺的话要么装对应的包要么把库一起打进 deb 包里。5. 那些让我熬夜的坑与对应的排查思路5.1 链接时找到 x86 库CMAKE_FIND_ROOT_PATH 的陷阱这个坑我踩过不止一次。症状是链接阶段报skipping incompatible /usr/lib/x86_64-linux-gnu/libz.so然后报undefined reference to inflate。原因是 CMake 在找 zlib 时先找到了宿主系统的 x86 版本发现架构不匹配就跳过但没有继续去找 arm64 版本最后链接时符号缺失。根因是CMAKE_FIND_ROOT_PATH没有正确配置或者配置了但路径下确实没有 arm64 的库。排查步骤先确认 toolchain file 里CMAKE_FIND_ROOT_PATH指向的目录存在且包含 arm64 库然后用cmake --debug-find重新配置看 CMake 到底在哪些路径下找了库最后确认找到的库文件用file命令看是不是 ARM aarch64。解决方式就是前面说的把 arm64 的依赖库解压到 sysroot 目录并确保CMAKE_FIND_ROOT_PATH包含这个目录。如果实在搞不定退而求其次把依赖库静态编译进去-DCMAKE_EXE_LINKER_FLAGS-static但这样会让二进制变大而且 glibc 静态链接有已知问题慎用。5.2 dpkg -i 报架构不匹配control 文件的 Architecture 字段症状是板子上dpkg -i直接拒绝报package architecture (amd64) does not match system (arm64)。原因就是 control 文件里 Architecture 写成了amd64。这个错误通常发生在你用了dh_make之类的工具自动生成 control 文件而工具默认按宿主架构填了。排查很简单dpkg-deb -I xxx.deb看 Architecture 字段。修复就是改 control 文件重新打包。但要注意如果你用的是dh_make它生成的debian/control里 Architecture 可能是any这个在交叉编译时需要改成arm64或者在debian/rules里设置DEB_HOST_ARCHarm64。5.3 板子上运行报 Illegal instructionCPU 特性不匹配这个坑比较隐蔽。编译成功了安装也成功了但一运行就Illegal instruction。原因是交叉编译器默认可能针对某个较高的 ARM 架构版本或者开启了某些 CPU 特性比如 NEON、CRC而你的板子 CPU 不支持。排查用aarch64-linux-gnu-objdump -d myapp | head -50看反汇编找有没有特殊指令。更直接的是看编译选项-march和-mtune是什么。默认情况下 GCC 的-march是armv8-a这个几乎所有 arm64 CPU 都支持。但如果你手动加了-marcharmv8.2-acrc之类的就可能出问题。解决方式是明确指定-marcharmv8-a不要开额外的特性。如果性能确实需要先确认板子 CPU 支持哪些特性cat /proc/cpuinfo看 Features 行再针对性开启。5.4 WSL 里编译速度突然变慢文件系统和内存的锅有时候你会发现编译速度莫名其妙变慢之前 2 分钟能编完的现在要 10 分钟。两个常见原因。第一是源码放在了/mnt/c下跨文件系统访问导致 IO 瓶颈。解决就是把源码移到~/下。第二是 WSL 的内存被其他进程占满了开始用 swap速度断崖式下跌。用free -h看内存和 swap 使用情况如果 swap 用了很多说明内存不够要么加.wslconfig里的 memory要么关掉一些占内存的进程。还有一个不太常见但很坑的原因WSL 的时钟漂移。长时间休眠后唤醒WSL 的时钟可能和宿主机不同步导致make判断文件时间戳出错反复重编。sudo hwclock -s可以同步时钟。5.5 依赖库版本在板子上对不上Depends 字段的粒度你声明了Depends: libssl3但板子上装的是libssl1.1dpkg -i就报依赖不满足。或者反过来你声明了libssl1.1板子上是libssl3同样装不上。这个问题的根源是不同 Linux 发行版、不同版本之间的库版本差异很大。处理策略是如果板子是你自己能控制的尽量统一基础系统版本比如都用 Ubuntu 22.04 或者都用 Debian 12。如果板子是客户环境你无法控制那就把依赖库一起打进 deb 包里装到/usr/lib/myapp/下然后用RPATH让程序优先从自己的目录加载库。CMake 里设置set(CMAKE_INSTALL_RPATH $ORIGIN/../lib/myapp) set(CMAKE_BUILD_WITH_INSTALL_RPATH TRUE)$ORIGIN是运行时程序所在目录这样程序会先在自己的相对路径下找库找不到再用系统的。这种方式叫私有依赖能极大降低对系统环境的依赖。6. 让这套流程更顺手的几个实践6.1 用脚本把整个流程串起来每次手动敲一堆命令很容易出错我习惯写一个build.sh把流程固化下来#!/bin/bash set -e VERSION1.0.0 PKGNAMEmyapp ARCHarm64 BUILD_DIRbuild PKG_ROOTpkgroot rm -rf $BUILD_DIR $PKG_ROOT mkdir -p $BUILD_DIR cd $BUILD_DIR cmake -DCMAKE_TOOLCHAIN_FILE../arm64-toolchain.cmake \ -DCMAKE_INSTALL_PREFIX/usr \ -DCMAKE_BUILD_TYPERelease \ -DCMAKE_INSTALL_RPATH$ORIGIN/../lib/myapp \ .. make -j$(nproc) make DESTDIR../$PKG_ROOT install cd .. mkdir -p $PKG_ROOT/DEBIAN cp debian/control $PKG_ROOT/DEBIAN/control cp debian/postinst $PKG_ROOT/DEBIAN/postinst chmod 755 $PKG_ROOT/DEBIAN/postinst dpkg-deb --build --root-owner-group $PKG_ROOT \ ${PKGNAME}_${VERSION}_${ARCH}.deb echo Package built: ${PKGNAME}_${VERSION}_${ARCH}.deb这个脚本把清理、配置、编译、安装到临时目录、打包全串起来了。每次改完代码跑一遍几十秒到几分钟就能拿到新的 deb 包。配合scp和板子上的dpkg -i整个迭代循环非常快。6.2 在板子上做一次干净的安装测试开发阶段你可能反复dpkg -i覆盖安装但有些问题只在全新安装时才会暴露比如 postinst 脚本里的逻辑、依赖声明是否完整。所以正式发布前一定要在干净的板子系统上测一次。如果板子不方便重装系统可以用 Docker 在板子上模拟一个干净环境如果板子性能允许或者至少先sudo dpkg -P myapp彻底卸载再重新安装。-P是 purge会连配置文件一起删掉比-r更彻底。6.3 版本号和变更记录的管理deb 包的 Version 字段不只是个数字它影响升级行为。dpkg比较版本号用的是 Debian 的版本比较算法1.0.0小于1.0.11.0.0-1小于1.0.0-2。如果你每次打包都用同一个版本号dpkg -i会认为没有变化可能跳过某些配置步骤。我的习惯是用主版本.次版本.修订号-打包序号的格式比如1.0.0-1、1.0.0-2。每次重新打包打包序号加一。这样既能体现代码版本又能区分同一次代码的不同打包。配合debian/changelog文件记录每次变更出问题时能快速定位是哪个版本引入的。6.4 关于 qemu 验证的实用建议虽然交叉编译出来的程序不能直接在 WSL 里跑但可以用 qemu-user 做快速验证不用每次都拷到板子上。安装sudo apt install qemu-user-static binfmt-support装完之后理论上可以直接运行 arm64 二进制binfmt 会自动调用 qemu。但实际体验是对于简单的命令行程序没问题对于依赖图形界面、特定硬件、systemd 的程序qemu 里跑不起来或者行为不一致。所以 qemu 只适合做能不能启动、基本逻辑对不对的冒烟测试真正的功能验证还是得在板子上做。我一般用 qemu 验证两件事一是二进制能不能加载qemu-aarch64-static ./myapp --version二是动态库依赖是否齐全qemu-aarch64-static -L /opt/arm64-sysroot ./myapp。这两步过了再拷到板子上基本不会出现完全跑不起来的情况。6.5 一个容易被忽略的细节文件权限和属主deb 包里的文件权限会被原样安装到板子上。如果你在 WSL 里打包时某个脚本文件没有可执行权限装到板子上后它也没有可执行权限调用时就会报Permission denied。所以打包前一定要检查关键文件可执行程序、脚本的权限。dpkg-deb --root-owner-group解决了属主问题但权限问题它管不了。我的做法是在build.sh里加一步打包前统一设置权限find $PKG_ROOT -type f -name *.sh -exec chmod 755 {} \; find $PKG_ROOT/usr/bin -type f -exec chmod 755 {} \;这样能避免大部分权限相关的安装后问题。 Windows WSL 交叉编译 arm64 deb 包实战指南
1. 为什么要在 Windows 上折腾 arm64 的 deb 包很多人第一次听到在 Windows 上打 arm64 的 deb 包这个需求第一反应是这不是自找麻烦吗直接在板子上编译不就完了。我一开始也是这么想的直到手上那块 RK3588 开发板只有 4GB 内存编译一个中等规模的 C 项目链接阶段直接被 OOM Killer 干掉swap 开到 8GB 还是卡到怀疑人生。后来换成树莓派 58GB 版本稍微好点但编译 Qt 这种体量的东西一个下午就没了板子还烫得能煎蛋。所以真实场景是这样的你手上有一台性能不错的 Windows 台式机或者笔记本32GB 内存、多核 CPU平时写代码、跑 IDE 都很爽但你的目标运行环境是 arm64 架构的 Linux 板子——可能是树莓派、RK 系列、全志系列也可能是国产化平台上的麒麟系统。你希望在这台 Windows 机器上把编译这件事干完最后只把产物拷到板子上装一下就行。这就是交叉编译最朴素的动机用强机器编译用弱机器运行。那为什么是 deb 包而不是直接 tar 包解压因为 deb 包解决的不只是打包这一个问题。它帮你管理安装路径、依赖声明、安装前后的脚本钩子、版本升级和卸载。你在板子上dpkg -i一行命令它自动把文件放到/usr/bin、/usr/lib、/etc这些标准位置还会检查依赖是否满足。如果你只是 tar 包解压这些事全得手动做装十个软件就有十套不同的目录结构维护成本极高。尤其是当你要给多块板子、多个同事部署同一套东西时deb 包的价值就体现出来了。而 WSL 在这里扮演的角色是一个几乎零成本的 Linux 编译宿主。你不需要装双系统不需要开虚拟机虚拟机还要分配内存、配网络、传文件WSL2 直接在你的 Windows 里跑一个真实的 Linux 内核文件系统互通网络互通还能调用 Windows 的图形界面。你可以在 Windows 上用 VS Code 写代码在 WSL 里编译产物直接落在 Windows 磁盘上再通过 scp 或者 U 盘拷到板子。整条链路非常顺。不过这里有个关键点必须先说清楚WSL 默认是 x86_64 架构的。你uname -m看到的是x86_64不是aarch64。所以你不能指望在 WSL 里直接gcc一下就产出 arm64 的二进制。你需要的是交叉编译工具链——一套运行在 x86_64 上、但生成 arm64 代码的编译器。这是整件事的技术核心也是最多人卡住的地方。提示交叉编译和在 WSL 里装 qemu 模拟 arm64 再编译是两条完全不同的路。qemu 模拟能跑通但速度慢到让你怀疑人生编译大型项目基本不可用。交叉编译才是正解qemu 只适合做最后的验证。2. 交叉编译工具链的选型与 WSL 环境准备2.1 三种工具链来源的取舍在 Linux 上做 arm64 交叉编译工具链的来源主要有三类我逐个说一下实际体验。第一类是发行版官方仓库里的包比如 Ubuntu 上的gcc-aarch64-linux-gnu和g-aarch64-linux-gnu。这是最省事的方式apt install一行搞定版本和系统匹配不会出现奇怪的链接错误。缺点是版本可能偏旧比如 Ubuntu 22.04 上默认是 GCC 11如果你需要 GCC 13 的新特性就不够用。但对于绝大多数项目GCC 11 完全够用。第二类是 Linaro 或者 ARM 官方发布的预编译工具链。这些工具链针对 ARM 平台做了优化版本更新支持的特性更全。下载下来解压把bin目录加到 PATH 里就能用。缺点是体积大动辄几百 MB 到 1GB而且有时候和宿主系统的 glibc 版本会有微妙的兼容问题。第三类是用 Yocto、Buildroot 或者 crosstool-NG 自己构建工具链。这种方式最灵活可以精确控制 glibc 版本、内核头文件版本、编译选项适合产品化场景。但构建一次工具链可能要几个小时而且配置复杂不适合快速验证。我的建议是先用发行版仓库的包把流程跑通确认整个链路没问题再根据实际需求决定要不要换更专业的工具链。很多人一上来就折腾 Linaro 工具链结果卡在环境变量或者库路径上连个 hello world 都没编译出来信心就没了。2.2 WSL 环境的几个关键配置WSL 的安装本身现在很简单wsl --install就行。但有几个配置点直接影响你后续的编译体验我踩过坑这里说清楚。首先是 WSL 的版本。必须用 WSL2不能用 WSL1。WSL1 是系统调用翻译层很多编译工具的行为不正常尤其是涉及fork、mmap、文件锁的操作。wsl --set-version Ubuntu-22.04 2可以切换。确认版本用wsl -l -v看到 VERSION 是 2 就对了。其次是内存和 CPU 分配。WSL2 默认会占用宿主机最多 50% 的内存在较新的版本里是 50% 或者 8GB 取小值。如果你宿主机是 32GBWSL 最多能用 16GB编译一般够用。但如果你的项目特别大可以在C:\Users\你的用户名\.wslconfig里手动配置[wsl2] memory24GB processors12 swap8GB改完wsl --shutdown重启生效。注意processors不要设成宿主机的全部核心数留一两个给 Windows 本身否则编译时整个系统会卡到没法用。第三是文件系统的选择。这是个容易被忽略但影响巨大的点。WSL 里访问 Windows 磁盘/mnt/c/...的性能很差因为跨了文件系统边界。如果你把源码放在/mnt/c/Users/xxx/project下编译会比放在 WSL 自己的文件系统~/project里慢好几倍。我实测过一个中型项目放在/mnt/c下编译要 8 分钟放在~下只要 2 分半。所以源码一定要放在 WSL 的原生文件系统里编译完再把产物拷出去。但这里有个矛盾你可能习惯用 Windows 上的编辑器打开源码。解决办法是用 VS Code 的 Remote-WSL 插件它让你在 Windows 的 VS Code 界面里直接编辑 WSL 里的文件体验和本地编辑几乎一样但文件实际在 WSL 文件系统里。这个组合我用了一年多非常顺。2.3 安装交叉编译工具链的完整命令以 Ubuntu 22.04 为例装 arm64 交叉编译工具链sudo apt update sudo apt install -y gcc-aarch64-linux-gnu g-aarch64-linux-gnu \ binutils-aarch64-linux-gnu \ cmake make ninja-build pkg-config装完之后验证一下aarch64-linux-gnu-gcc --version aarch64-linux-gnu-gcc -dumpmachine第二条命令应该输出aarch64-linux-gnu说明工具链的目标架构是对的。然后写个 hello world 测试echo int main(){return 0;} test.c aarch64-linux-gnu-gcc test.c -o test_arm64 file test_arm64file命令应该显示ELF 64-bit LSB executable, ARM aarch64。如果显示的是 x86_64说明你用的还是本机 gcc不是交叉编译器检查一下命令名是不是写错了。注意交叉编译出来的二进制不能在 WSL 里直接运行架构不匹配会报cannot execute binary file: Exec format error。这是正常的不要以为编译失败了。要验证运行得用 qemu-user 或者直接拷到板子上。3. 从源码到 deb打包流程的每一步拆解3.1 先搞清楚 deb 包的目录结构约定很多人打 deb 包失败根本原因是不了解 deb 包的内部结构约定。一个 deb 包本质上是一个 ar 归档里面包含control.tar.gz元数据和脚本和data.tar.gz实际文件。但你在制作时不需要手动构造这些用dpkg-deb或者dh_make这类工具就行。关键是data.tar.gz里的目录结构。deb 包安装时是把data目录下的内容原样解压到根目录/。所以如果你想让程序装到/usr/bin/myapp你的打包目录里就得有usr/bin/myapp这个路径。这个根目录镜像的概念是理解 deb 打包的核心。一个典型的打包工作目录长这样myapp-1.0/ ├── DEBIAN/ │ ├── control │ ├── postinst │ └── prerm └── usr/ ├── bin/ │ └── myapp ├── lib/ │ └── myapp/ │ └── libhelper.so └── share/ └── myapp/ └── config.jsonDEBIAN目录全大写是元数据目录不会被打进data.tar.gz而是单独处理。其他目录就是实际安装的文件。这个结构你手动建也行用工具生成也行但必须符合这个约定。3.2 control 文件deb 包的身份证DEBIAN/control是 deb 包最重要的文件它决定了包名、版本、架构、依赖关系。一个最小可用的 control 文件Package: myapp Version: 1.0.0 Architecture: arm64 Maintainer: yourname youremail.com Depends: libc6 ( 2.31), libstdc6 Description: A demo application for arm64 This is a longer description that can span multiple lines. Each line after the first must start with a space.这里有几个坑必须说。Architecture 字段交叉编译时这里必须写arm64不能写amd64或者all。如果你写错了dpkg -i在板子上会直接拒绝安装报架构不匹配。all只适用于纯脚本、纯数据这种和架构无关的包。Depends 字段这是依赖声明格式是包名 (版本约束)多个依赖用逗号分隔。这里最容易出问题的是版本约束写得太死或者太松。写太死板子上版本稍微低一点就装不上写太松运行时缺库崩溃。我的经验是对于系统基础库libc6、libstdc6给一个最低版本约束就行不要写上限。对于你自己依赖的第三方库如果板子上可能没有要么在 Depends 里声明要么干脆静态链接进去。Description 字段第一行是简短描述后面可以跟多行详细描述但每一行续行都必须以空格开头。这个格式很严格少一个空格就会解析失败。我见过有人在这里栽跟头dpkg-deb --build直接报 control 文件格式错误。3.3 用 CMake 工具链文件驱动交叉编译如果你的项目用 CMake交叉编译的关键是提供一个 toolchain file。这个文件告诉 CMake 用哪个编译器、目标系统是什么、去哪里找库。一个实用的arm64-toolchain.cmakeset(CMAKE_SYSTEM_NAME Linux) set(CMAKE_SYSTEM_PROCESSOR aarch64) set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc) set(CMAKE_CXX_COMPILER aarch64-linux-gnu-g) set(CMAKE_FIND_ROOT_PATH /usr/aarch64-linux-gnu) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)CMAKE_FIND_ROOT_PATH_MODE_*这几行非常关键。它们控制 CMake 在找程序、库、头文件时的搜索策略。PROGRAM设为NEVER表示找可执行程序比如构建工具时用宿主系统的不要用目标系统的LIBRARY、INCLUDE、PACKAGE设为ONLY表示找库和头文件时只在目标根路径下找不要误用宿主系统的 x86 库。这个配置如果搞错最常见的症状是链接时报skipping incompatible /usr/lib/x86_64-linux-gnu/libxxx.so意思就是 CMake 找到了 x86 的库架构不匹配。使用方式mkdir build cd build cmake -DCMAKE_TOOLCHAIN_FILE../arm64-toolchain.cmake \ -DCMAKE_INSTALL_PREFIX/usr \ -DCMAKE_BUILD_TYPERelease .. make -j$(nproc) make DESTDIR../pkgroot installDESTDIR是打包的关键。它让make install把文件装到一个临时根目录而不是真的装到/usr。这样pkgroot目录就变成了我们前面说的根目录镜像直接拿它去打包就行。3.4 处理第三方依赖交叉编译最烦人的部分纯自己写的代码交叉编译很简单麻烦的是依赖第三方库。比如你的程序用了 OpenSSL、zlib、libcurl这些库在 WSL 里装的是 x86 版本交叉编译时链接会失败。解决办法有三种。第一种是找这些库的 arm64 版本用dpkg -i装到 WSL 里需要开 multiarch但这种方式容易把系统搞乱。第二种是用apt-get download下载 arm64 的 deb 包解压到某个目录然后在 toolchain file 里把CMAKE_FIND_ROOT_PATH指向这个目录。第三种是自己交叉编译这些依赖最干净但最费时间。我一般用第二种具体操作# 添加 arm64 架构支持 sudo dpkg --add-architecture arm64 # 但不要直接 apt install会污染系统 # 改用下载方式 apt-get download libssl-dev:arm64 dpkg-deb -x libssl-dev_*.deb /opt/arm64-sysroot然后把/opt/arm64-sysroot加到 toolchain file 的CMAKE_FIND_ROOT_PATH里。这样 CMake 就能找到 arm64 的头文件和库而不会误用系统的 x86 版本。提示dpkg --add-architecture arm64之后如果你不小心apt install了某个库可能会把系统里的 x86 版本替换掉导致 WSL 本身出问题。所以下载依赖时一定要用apt-get download而不是apt install或者用apt install 包名:arm64明确指定架构。4. 打包、传输与板子上的安装验证4.1 用 dpkg-deb 构建 deb 包假设你已经通过make DESTDIR../pkgroot install得到了pkgroot目录接下来补上DEBIAN目录cd pkgroot mkdir -p DEBIAN cat DEBIAN/control EOF Package: myapp Version: 1.0.0 Architecture: arm64 Maintainer: yourname youremail.com Depends: libc6 ( 2.31), libstdc6 Description: A demo application for arm64 Built with cross toolchain on WSL. EOF然后构建cd .. dpkg-deb --build --root-owner-group pkgroot myapp_1.0.0_arm64.deb--root-owner-group这个参数很重要。它把所有文件的属主和属组都设成 root避免把 WSL 里的用户名比如 uid 1000打进包里。如果不加这个参数装到板子上后文件属主会变成一个不存在的 uid虽然大多数情况不影响运行但看起来很不专业而且某些对权限敏感的程序会出问题。构建完成后验证一下包的内容dpkg-deb -I myapp_1.0.0_arm64.deb # 查看 control 信息 dpkg-deb -c myapp_1.0.0_arm64.deb # 查看文件列表-I输出里要确认 Architecture 是 arm64-c输出里要确认文件路径和权限符合预期。4.2 安装脚本postinst 和 prerm 的正确写法很多程序装完需要做一些初始化比如创建用户、建目录、注册服务。这些通过DEBIAN/postinst脚本完成。一个典型的 postinst#!/bin/bash set -e case $1 in configure) # 创建运行用户如果不存在 if ! id -u myapp /dev/null 21; then useradd --system --no-create-home --shell /usr/sbin/nologin myapp fi # 创建数据目录 mkdir -p /var/lib/myapp chown myapp:myapp /var/lib/myapp # 重载 systemd systemctl daemon-reload || true ;; abort-upgrade|abort-remove|abort-deconfigure) ;; *) echo postinst called with unknown argument: $1 2 exit 1 ;; esac exit 0几个要点。第一set -e让脚本遇到错误立即退出避免半途而废留下烂摊子。第二case $1是 deb 脚本的标准模式$1是操作类型configure是最常见的。第三脚本必须有可执行权限chmod 755 DEBIAN/postinst否则 dpkg 会报权限错误。第四脚本里调用 systemctl 要加|| true因为有些环境比如容器里没有 systemd不加会导致安装失败。prerm是卸载前执行的脚本一般用来停服务#!/bin/bash set -e case $1 in remove|deconfigure) systemctl stop myapp.service || true systemctl disable myapp.service || true ;; esac exit 0注意prerm里不要删用户和目录那是postrm的活。卸载时保留数据是更安全的做法万一用户是误卸载重装后数据还在。4.3 把 deb 包传到板子上传输方式取决于你的板子怎么连的。如果是网线或者 WiFi 连着同一个局域网最简单的是 scpscp myapp_1.0.0_arm64.deb pi192.168.1.100:/tmp/如果板子没联网用 U 盘拷也行。还有一种情况是板子通过串口连着那就得用sz/rz或者adb push如果板子支持 adb。我一般用 scp因为快且可靠。传过去之后在板子上安装sudo dpkg -i /tmp/myapp_1.0.0_arm64.deb如果依赖不满足会报dependency problems prevent configuration。这时候有两种处理方式。如果板子能联网直接sudo apt-get install -f自动修复依赖。如果不能联网就得手动把缺失的依赖 deb 包也拷过去按顺序安装。注意dpkg -i报依赖错误时包其实已经解压了只是没配置。这时候程序文件已经在/usr/bin下了但状态是iUunpacked but not configured。你可以用dpkg -l | grep myapp看状态。修复依赖后sudo dpkg --configure -a会重新配置所有未配置的包。4.4 验证安装结果装完之后验证几个点。第一dpkg -l myapp看状态是不是iiinstalled and configured。第二which myapp看可执行文件在不在 PATH 里。第三直接运行myapp --version看能不能跑起来。第四如果注册了 systemd 服务systemctl status myapp看服务状态。如果运行时报No such file or directory但文件明明存在八成是动态链接器路径不对。用readelf -l myapp | grep interpreter看一下解释器路径正常应该是/lib/ld-linux-aarch64.so.1。如果显示的是别的路径说明工具链的 sysroot 配置有问题需要重新编译。如果报error while loading shared libraries: libxxx.so.x: cannot open shared object file说明缺运行库。用aarch64-linux-gnu-objdump -p myapp | grep NEEDED看依赖了哪些库然后确认板子上有没有这些库。缺的话要么装对应的包要么把库一起打进 deb 包里。5. 那些让我熬夜的坑与对应的排查思路5.1 链接时找到 x86 库CMAKE_FIND_ROOT_PATH 的陷阱这个坑我踩过不止一次。症状是链接阶段报skipping incompatible /usr/lib/x86_64-linux-gnu/libz.so然后报undefined reference to inflate。原因是 CMake 在找 zlib 时先找到了宿主系统的 x86 版本发现架构不匹配就跳过但没有继续去找 arm64 版本最后链接时符号缺失。根因是CMAKE_FIND_ROOT_PATH没有正确配置或者配置了但路径下确实没有 arm64 的库。排查步骤先确认 toolchain file 里CMAKE_FIND_ROOT_PATH指向的目录存在且包含 arm64 库然后用cmake --debug-find重新配置看 CMake 到底在哪些路径下找了库最后确认找到的库文件用file命令看是不是 ARM aarch64。解决方式就是前面说的把 arm64 的依赖库解压到 sysroot 目录并确保CMAKE_FIND_ROOT_PATH包含这个目录。如果实在搞不定退而求其次把依赖库静态编译进去-DCMAKE_EXE_LINKER_FLAGS-static但这样会让二进制变大而且 glibc 静态链接有已知问题慎用。5.2 dpkg -i 报架构不匹配control 文件的 Architecture 字段症状是板子上dpkg -i直接拒绝报package architecture (amd64) does not match system (arm64)。原因就是 control 文件里 Architecture 写成了amd64。这个错误通常发生在你用了dh_make之类的工具自动生成 control 文件而工具默认按宿主架构填了。排查很简单dpkg-deb -I xxx.deb看 Architecture 字段。修复就是改 control 文件重新打包。但要注意如果你用的是dh_make它生成的debian/control里 Architecture 可能是any这个在交叉编译时需要改成arm64或者在debian/rules里设置DEB_HOST_ARCHarm64。5.3 板子上运行报 Illegal instructionCPU 特性不匹配这个坑比较隐蔽。编译成功了安装也成功了但一运行就Illegal instruction。原因是交叉编译器默认可能针对某个较高的 ARM 架构版本或者开启了某些 CPU 特性比如 NEON、CRC而你的板子 CPU 不支持。排查用aarch64-linux-gnu-objdump -d myapp | head -50看反汇编找有没有特殊指令。更直接的是看编译选项-march和-mtune是什么。默认情况下 GCC 的-march是armv8-a这个几乎所有 arm64 CPU 都支持。但如果你手动加了-marcharmv8.2-acrc之类的就可能出问题。解决方式是明确指定-marcharmv8-a不要开额外的特性。如果性能确实需要先确认板子 CPU 支持哪些特性cat /proc/cpuinfo看 Features 行再针对性开启。5.4 WSL 里编译速度突然变慢文件系统和内存的锅有时候你会发现编译速度莫名其妙变慢之前 2 分钟能编完的现在要 10 分钟。两个常见原因。第一是源码放在了/mnt/c下跨文件系统访问导致 IO 瓶颈。解决就是把源码移到~/下。第二是 WSL 的内存被其他进程占满了开始用 swap速度断崖式下跌。用free -h看内存和 swap 使用情况如果 swap 用了很多说明内存不够要么加.wslconfig里的 memory要么关掉一些占内存的进程。还有一个不太常见但很坑的原因WSL 的时钟漂移。长时间休眠后唤醒WSL 的时钟可能和宿主机不同步导致make判断文件时间戳出错反复重编。sudo hwclock -s可以同步时钟。5.5 依赖库版本在板子上对不上Depends 字段的粒度你声明了Depends: libssl3但板子上装的是libssl1.1dpkg -i就报依赖不满足。或者反过来你声明了libssl1.1板子上是libssl3同样装不上。这个问题的根源是不同 Linux 发行版、不同版本之间的库版本差异很大。处理策略是如果板子是你自己能控制的尽量统一基础系统版本比如都用 Ubuntu 22.04 或者都用 Debian 12。如果板子是客户环境你无法控制那就把依赖库一起打进 deb 包里装到/usr/lib/myapp/下然后用RPATH让程序优先从自己的目录加载库。CMake 里设置set(CMAKE_INSTALL_RPATH $ORIGIN/../lib/myapp) set(CMAKE_BUILD_WITH_INSTALL_RPATH TRUE)$ORIGIN是运行时程序所在目录这样程序会先在自己的相对路径下找库找不到再用系统的。这种方式叫私有依赖能极大降低对系统环境的依赖。6. 让这套流程更顺手的几个实践6.1 用脚本把整个流程串起来每次手动敲一堆命令很容易出错我习惯写一个build.sh把流程固化下来#!/bin/bash set -e VERSION1.0.0 PKGNAMEmyapp ARCHarm64 BUILD_DIRbuild PKG_ROOTpkgroot rm -rf $BUILD_DIR $PKG_ROOT mkdir -p $BUILD_DIR cd $BUILD_DIR cmake -DCMAKE_TOOLCHAIN_FILE../arm64-toolchain.cmake \ -DCMAKE_INSTALL_PREFIX/usr \ -DCMAKE_BUILD_TYPERelease \ -DCMAKE_INSTALL_RPATH$ORIGIN/../lib/myapp \ .. make -j$(nproc) make DESTDIR../$PKG_ROOT install cd .. mkdir -p $PKG_ROOT/DEBIAN cp debian/control $PKG_ROOT/DEBIAN/control cp debian/postinst $PKG_ROOT/DEBIAN/postinst chmod 755 $PKG_ROOT/DEBIAN/postinst dpkg-deb --build --root-owner-group $PKG_ROOT \ ${PKGNAME}_${VERSION}_${ARCH}.deb echo Package built: ${PKGNAME}_${VERSION}_${ARCH}.deb这个脚本把清理、配置、编译、安装到临时目录、打包全串起来了。每次改完代码跑一遍几十秒到几分钟就能拿到新的 deb 包。配合scp和板子上的dpkg -i整个迭代循环非常快。6.2 在板子上做一次干净的安装测试开发阶段你可能反复dpkg -i覆盖安装但有些问题只在全新安装时才会暴露比如 postinst 脚本里的逻辑、依赖声明是否完整。所以正式发布前一定要在干净的板子系统上测一次。如果板子不方便重装系统可以用 Docker 在板子上模拟一个干净环境如果板子性能允许或者至少先sudo dpkg -P myapp彻底卸载再重新安装。-P是 purge会连配置文件一起删掉比-r更彻底。6.3 版本号和变更记录的管理deb 包的 Version 字段不只是个数字它影响升级行为。dpkg比较版本号用的是 Debian 的版本比较算法1.0.0小于1.0.11.0.0-1小于1.0.0-2。如果你每次打包都用同一个版本号dpkg -i会认为没有变化可能跳过某些配置步骤。我的习惯是用主版本.次版本.修订号-打包序号的格式比如1.0.0-1、1.0.0-2。每次重新打包打包序号加一。这样既能体现代码版本又能区分同一次代码的不同打包。配合debian/changelog文件记录每次变更出问题时能快速定位是哪个版本引入的。6.4 关于 qemu 验证的实用建议虽然交叉编译出来的程序不能直接在 WSL 里跑但可以用 qemu-user 做快速验证不用每次都拷到板子上。安装sudo apt install qemu-user-static binfmt-support装完之后理论上可以直接运行 arm64 二进制binfmt 会自动调用 qemu。但实际体验是对于简单的命令行程序没问题对于依赖图形界面、特定硬件、systemd 的程序qemu 里跑不起来或者行为不一致。所以 qemu 只适合做能不能启动、基本逻辑对不对的冒烟测试真正的功能验证还是得在板子上做。我一般用 qemu 验证两件事一是二进制能不能加载qemu-aarch64-static ./myapp --version二是动态库依赖是否齐全qemu-aarch64-static -L /opt/arm64-sysroot ./myapp。这两步过了再拷到板子上基本不会出现完全跑不起来的情况。6.5 一个容易被忽略的细节文件权限和属主deb 包里的文件权限会被原样安装到板子上。如果你在 WSL 里打包时某个脚本文件没有可执行权限装到板子上后它也没有可执行权限调用时就会报Permission denied。所以打包前一定要检查关键文件可执行程序、脚本的权限。dpkg-deb --root-owner-group解决了属主问题但权限问题它管不了。我的做法是在build.sh里加一步打包前统一设置权限find $PKG_ROOT -type f -name *.sh -exec chmod 755 {} \; find $PKG_ROOT/usr/bin -type f -exec chmod 755 {} \;这样能避免大部分权限相关的安装后问题。 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
