4. 开发环境搭建：交叉编译环境配置、远程开发与调试、Docker容器化部署、边缘设备系统烧录

好，咱们进入第四章。这一章，说白了就是“磨刀”。刀磨得快不快，直接决定你后面砍柴累不累。我见过太多同学，算法模型调得飞起，结果卡在环境搭建上，一卡就是两三天。嗯，咱们今天就把这关过了。

4.1 交叉编译环境配置

先说说交叉编译。你想想看，你的开发电脑是x86架构，但边缘设备往往是ARM架构。你在x86上编译出来的程序，ARM设备根本跑不了。怎么办？就得用交叉编译工具链。

我个人习惯，把交叉编译工具链安装在 /opt/toolchains/ 目录下。这样好管理，也方便多版本共存。

核心步骤：

  1. 下载对应芯片厂商提供的交叉编译工具链（比如ARM的gcc-linaro系列）
  2. 解压到指定目录
  3. 配置环境变量 PATH 和 LD_LIBRARY_PATH
  4. 验证：运行 arm-linux-gnueabihf-gcc --version

我曾经在项目里踩过一个坑：下载了错误的工具链版本，导致编译出来的程序在设备上段错误。后来才发现，工具链的glibc版本必须和设备上的系统库版本匹配。这个一定要注意。

# 以ARM Cortex-A72为例
export CROSS_COMPILE=arm-linux-gnueabihf-
export CC=${CROSS_COMPILE}gcc
export CXX=${CROSS_COMPILE}g++
export AR=${CROSS_COMPILE}ar
export LD=${CROSS_COMPILE}ld

# 验证
${CC} --version
# 输出类似：arm-linux-gnueabihf-gcc (Linaro GCC 7.5-2019.12) 7.5.0

我的小技巧：写一个 setenv.sh 脚本，把环境变量都放进去。每次新开终端，source一下就行。别每次都手动敲，容易出错。

4.2 远程开发与调试（SSH / VSCode Remote）

交叉编译环境配好了，但你总不能每次编译完都拿U盘拷到设备上吧？太原始了。咱们用SSH远程开发。

VSCode的Remote - SSH插件，说实话，是我这几年用过最爽的开发方式之一。你想想看，本地写代码，远程编译调试，就跟在本地操作一样流畅。

配置步骤：

  1. 边缘设备上开启SSH服务：sudo systemctl start sshd
  2. 本地VSCode安装Remote - SSH插件
  3. 配置 ~/.ssh/config 文件，设置主机别名、IP、端口
  4. 连接后，VSCode会自动在远程设备上安装服务器端组件
# ~/.ssh/config 示例
Host edge-device
    HostName 192.168.1.100
    User root
    Port 22
    IdentityFile ~/.ssh/id_rsa_edge

连接上之后，你可以在VSCode里直接打开设备上的文件夹，编辑代码，甚至用终端窗口执行命令。调试的时候，配置一个 launch.json，指定远程路径和可执行文件，就能断点调试了。

注意：远程调试时，网络延迟会影响体验。我建议用有线连接，或者至少保证Wi-Fi信号稳定。无线掉包的时候，调试器会卡得让你怀疑人生。

4.3 Docker容器化部署

环境搭好了，但有个问题：你换一台电脑，或者换一个项目，环境又得重来一遍。这时候Docker就派上用场了。

说白了，Docker就是把你的整个开发环境打包成一个“箱子”。到哪都能用，一模一样的环境，再也不用担心“在我电脑上能跑啊”这种问题。

我的做法：

  • 基础镜像：用 arm64v8/ubuntu:20.04 作为基础
  • 安装交叉编译工具链、CMake、Python、OpenCV等依赖
  • 把项目代码挂载进去，或者直接COPY进去
  • 编译出来的产物，通过卷映射拿出来
# Dockerfile 示例
FROM arm64v8/ubuntu:20.04

RUN apt-get update && apt-get install -y \
    build-essential \
    cmake \
    python3-pip \
    libopencv-dev \
    && rm -rf /var/lib/apt/lists/*

# 安装交叉编译工具链
COPY gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz /opt/
RUN tar -xf /opt/gcc-linaro-*.tar.xz -C /opt/ \
    && rm /opt/*.tar.xz

ENV PATH="/opt/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf/bin:${PATH}"

WORKDIR /workspace
CMD ["/bin/bash"]

构建镜像：docker build -t edge-dev-env:latest .

运行容器：docker run -it --rm -v $(pwd):/workspace edge-dev-env:latest

避坑指南：我曾经在Docker里编译了一个AI模型推理程序，结果放到设备上跑，发现缺少 libcuda.so。后来才意识到，GPU相关的库不能打包进镜像，因为设备上的GPU驱动版本可能不同。正确的做法是：把设备上的 /usr/lib/aarch64-linux-gnu/ 目录挂载进容器。

4.4 边缘设备系统烧录

最后一步，把系统烧录到边缘设备上。这一步看似简单，但做不好，设备直接变砖。

我常用的设备是NVIDIA Jetson系列和Rockchip系列。烧录方式大同小异，核心就是：把系统镜像写入SD卡或eMMC。

通用步骤：

  1. 下载官方提供的系统镜像（比如JetPack、Ubuntu for Rockchip）
  2. 准备一张高速SD卡（建议Class 10以上，32GB起步）
  3. 使用 balenaEtcher 或 dd 命令写入镜像
  4. 插入SD卡，上电启动
  5. 首次启动配置：用户名、密码、网络、时区
# 使用dd命令烧录（Linux/Mac）
# 注意：确认sd卡设备名，别写错了！
sudo dd if=ubuntu-20.04.6-preinstalled-server-arm64+raspi.img of=/dev/sdb bs=4M status=progress

# 烧录完成后，同步并卸载
sync
sudo eject /dev/sdb

警告：dd 命令非常危险。我曾经有一次没看清楚设备名，把电脑的硬盘给覆盖了……嗯，从那以后我每次都用 lsblk 确认三遍才敢下手。建议新手用 balenaEtcher，有图形界面，不容易出错。

烧录完成后，插卡上电。第一次启动会比较慢，因为系统要扩展分区、初始化服务。耐心等几分钟。如果设备有HDMI输出，接上显示器看看启动日志，能快速定位问题。

我的习惯：系统启动后，第一件事就是固定IP地址，然后开启SSH。这样后面就可以完全远程操作了，不用再插显示器和键盘。省事。

好，环境搭建这块就讲完了。你把这些步骤走一遍，后面开发就会顺畅很多。下一章，咱们开始真正写代码，跑第一个边缘AI推理程序。

← 上一章 📖 返回目录 下一章 →