最可控、最可复现的方式是直接用 dockerfile 定制带完整交叉编译链的镜像；应选用 ubuntu:22.04 等 debian/ubuntu 官方镜像，安装 gcc-aarch64-linux-gnu、libqt5core5a:arm64 等工具链与目标库，并设置 cc/cxx/pkg_config_path，最后通过编译器版本、pkg-config 和最小 cmake 构建验证环境就绪。
直接用 Dockerfile 定制一个带完整交叉编译链的镜像，是最可控、最可复现的方式。不需要依赖外部脚本或半成品镜像，自己掌握构建逻辑，才能适配 Qt、OpenCV、FFmpeg 这类复杂依赖的真实项目。
选对基础镜像，省掉一半麻烦
优先选用 Debian 或 Ubuntu 的官方镜像，比如 ubuntu:22.04。它们软件源稳定，交叉编译工具链和目标平台库（如 gcc-aarch64-linux-gnu、libqt5core5a:arm64）都有良好支持。避免用 Alpine，虽然体积小，但 glibc 兼容性差，Qt 和 OpenCV 构建容易失败。
- Debian/Ubuntu 提供
:arm64、:armhf等多架构后缀包，apt 直接安装即可 - 基础镜像本身是 x86_64，但通过安装目标平台工具链和库，就能变成 ARM 编译环境
- 别用
FROM arm64v8/ubuntu:22.04——那是在 ARM 主机上运行的容器，不是用来编译 ARM 程序的
在Dockerfile里装齐工具链和目标库
关键不是只装编译器，而是把整个目标平台的“运行时依赖”也一并装进去。否则 cmake 找不到 Qt，pkg-config 查不到 opencv，链接阶段就报错。
- 安装交叉编译器：
apt-get install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu - 安装目标平台系统库：
dpkg --add-architecture arm64 && apt-get update && apt-get install -y libqt5core5a:arm64 libopencv-dev:arm64 - 设置环境变量：
ENV CC=aarch64-linux-gnu-gcc CXX=aarch64-linux-gnu-g++ PKG_CONFIG_PATH=/usr/lib/aarch64-linux-gnu/pkgconfig
验证环境是否真正可用
构建完镜像别急着用，先交互式进容器跑个最小验证：
- 执行
aarch64-linux-gnu-gcc --version确认编译器存在 - 运行
pkg-config --modversion Qt5Core看是否返回版本号 - 写一个极简的
main.cpp+CMakeLists.txt，用cmake -DCMAKE_TOOLCHAIN_FILE=...或手动指定-DCMAKE_CXX_COMPILER=aarch64-linux-gnu-g++尝试 configure
能成功生成 Makefile 并完成 make，才算环境真正就绪。
分享和复用要靠清晰的标签与文档
镜像推送到仓库时，用语义化标签，比如 myorg/qt-opencv-arm64:v1.2，而不是 latest。同时附一份简短 README.md，说明：
- 目标平台（
linux/arm64）和宿主要求（Docker ≥ 23.0） - 预装组件清单：工具链版本、Qt 版本、OpenCV 版本
- 典型使用方式：
docker run --rm -v $(pwd):/src -w /src myorg/qt-opencv-arm64:v1.2 cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=/toolchain.cmake && cmake --build build
不复杂但容易忽略。
