3. 开发环境搭建

嵌入式Linux开发与桌面应用开发最大的差异在于：代码在主机上编写和编译，却运行在另一套CPU架构的目标板上。因此开发环境不是“装个IDE”那么简单，而是一条从主机到目标板的完整工具链与调试链路。本章围绕主机环境、交叉编译工具链、串口与网络调试工具、版本控制与目录规划四个环节，搭建一套可复用、可迁移的工程化开发环境。

一、主机环境选择：Ubuntu LTS 是工程默认解

主机环境决定了后续工具链、依赖库和脚本的兼容性。嵌入式Linux生态中，绝大多数芯片原厂SDK、Yocto/Buildroot构建系统都以Linux为第一支持平台，因此主机首选Linux发行版。推荐使用Ubuntu 22.04 LTS或20.04 LTS，原因有三：软件源中交叉工具链与调试工具齐全；长期支持版本生命周期长，避免频繁升级破坏环境；社区资料与厂商文档覆盖最广。

主机配置建议：至少4核CPU、8GB内存（构建Yocto建议16GB以上）、100GB以上空闲磁盘，并使用SSD。若使用Windows，可通过WSL2安装Ubuntu，但串口直通与USB设备访问需要额外配置；虚拟机方案则要确保USB控制器可直通串口转接器。主机与目标板应处于同一局域网，便于NFS挂载与TFTP传输。

二、交叉编译工具链安装：从“能编译”到“能运行”

交叉编译工具链是整套环境的核心，它包含交叉编译器、链接器、汇编器以及目标平台的C库。工具链的命名遵循“架构-厂商-操作系统-ABI”规则，例如arm-linux-gnueabihf-表示ARM架构、Linux系统、使用硬浮点ABI。选择工具链时，必须与目标板的CPU架构、浮点ABI、C库类型（glibc或musl）严格匹配，否则会出现“编译通过、运行报错”的典型问题。

安装方式主要有三种：使用发行版软件源安装（如gcc-arm-linux-gnueabihf）、使用芯片原厂提供的SDK工具链、使用Buildroot/Yocto自动生成。工程实践中推荐优先使用原厂SDK工具链，因为它与目标板内核、驱动、根文件系统版本一致，兼容性最好。

# 方式一：apt安装（快速验证）
sudo apt install gcc-arm-linux-gnueabihf

# 方式二：原厂工具链解压并加入PATH
tar -xJf gcc-arm-10.3-x86_64-arm-none-linux-gnueabihf.tar.xz -C /opt
export PATH=/opt/gcc-arm-10.3/bin:$PATH

# 验证
arm-linux-gnueabihf-gcc -v
arm-linux-gnueabihf-gcc hello.c -o hello
file hello   # 应显示 ARM, EABI5, dynamically linked

验证工具链是否可用，不能只看-v版本号，还要实际编译一个程序并用file确认目标架构，再拷贝到目标板运行。只有“编译—传输—运行”三步都通过，工具链才算真正可用。

三、串口与网络调试工具配置

串口是嵌入式开发中最可靠的“生命线”，用于查看U-Boot和内核启动日志、登录控制台。主机侧常用工具为minicom、picocom或screen。配置时需确认串口号、波特率（常见115200）、数据位8、无校验、停止位1、无流控。

# 查看串口设备
ls /dev/ttyUSB*
# 将当前用户加入dialout组，避免每次sudo
sudo usermod -aG dialout $USER
# 使用picocom连接
picocom -b 115200 /dev/ttyUSB0
# 退出：Ctrl+A 再按 Ctrl+Q

网络调试工具用于文件传输与远程登录。TFTP适合传输内核和设备树，NFS适合挂载根文件系统，SSH/SCP适合日常文件同步。主机需安装并启动对应服务：

sudo apt install tftp-hpa tftpd-hpa nfs-kernel-server openssh-server
# 目标板侧常用命令
tftp -g -r zImage 192.168.1.100
mount -t nfs -o nolock 192.168.1.100:/nfsroot /mnt
scp user@192.168.1.100:/home/user/app /tmp

下表汇总了常用调试工具及其用途，便于按场景选择：

四、版本控制与工程目录规划

嵌入式项目往往包含U-Boot、内核、根文件系统、应用程序、脚本和文档，若没有版本控制，很容易出现“改坏了回不去”的问题。推荐使用Git管理自研代码与配置文件，对于原厂SDK这类大体积代码，可采用Git子模块或单独仓库管理，避免主仓库臃肿。

目录规划应遵循“源码、构建、输出、工具、文档”分离原则。一个可落地的工程目录如下：

project/
├── bootloader/        # U-Boot源码与配置
├── kernel/            # 内核源码、设备树、defconfig
├── rootfs/            # 根文件系统构建配置
├── apps/              # 自研应用程序
├── scripts/           # 编译、打包、烧录脚本
├── tools/             # 交叉工具链、烧录工具
├── output/            # 编译产物（镜像、根文件系统）
├── docs/              # 硬件手册、引脚表、调试记录
└── .gitignore         # 忽略output、临时文件

建议在scripts/中提供统一入口脚本，例如build.sh、flash.sh、env.sh，把工具链路径、目标板IP、串口设备等参数集中管理。这样新成员加入时，只需执行source env.sh即可获得一致的开发环境。

五、环境验证与复盘

环境搭建完成后，应按“串口能看日志、网络能传文件、工具链能编译、目标板能运行”四条标准逐项验证。建议编写一份环境自检脚本，自动检查工具链版本、串口权限、TFTP/NFS服务状态和网络连通性。复盘时重点关注：工具链ABI是否与目标板一致、串口是否被其他进程占用、NFS挂载参数是否缺少nolock、防火墙是否拦截了TFTP端口。把这些检查项固化为脚本，可以显著降低后续章节中因环境问题导致的排障成本。