由 dawei 
AI生成3D模型，仅供参考
嵌入式Linux开发高度依赖稳定、可复现的Unix环境，但新手常在环境搭建中陷入低效试错。以下几点是高频踩坑点，值得提前规避。
切勿直接使用宿主机系统默认的Shell和工具链。Ubuntu/Debian默认使用dash作为/bin/sh，而许多Makefile或构建脚本隐式依赖bash特性（如数组、扩展通配符），导致编译中途失败。建议显式将/bin/sh指向bash：sudo dpkg-reconfigure dash，选择“否”；或在脚本首行统一写#!/bin/bash而非#!/bin/sh。
交叉编译工具链务必验证ABI兼容性。下载预编译工具链（如Linaro或ARM GNU Toolchain）后，先运行arm-linux-gnueabihf-gcc -v确认target为arm-linux-gnueabihf，再用readelf -A test.o检查生成目标是否含正确的Tag_ABI_VFP_args等标志。常见错误是混用gnueabi（软浮点）与gnueabihf（硬浮点），导致裸机启动失败或浮点异常。
构建根文件系统时，避免手工复制动态库。ldd输出的路径多为宿主机路径（如/lib/x86_64-linux-gnu），直接拷贝会导致库缺失或架构不匹配。应使用qemu-arm-static + chroot配合debootstrap，或使用Buildroot/Yocto等框架自动生成，确保所有依赖库均来自目标ABI且版本对齐。
调试环境易忽略QEMU用户模式的权限陷阱。运行qemu-arm-static ./app时若提示“Exec format error”，除检查二进制格式外，还需确认qemu-arm-static已注册为binfmt_misc处理器：检查/proc/sys/fs/binfmt_misc/qemu-arm是否存在，否则需手动注册（echo ':qemu-arm:M::\\x7fELF\\x01\\x01\\x01\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x02\\x00\\x28\\x00:\\xff\\xff\\xff\\xff\\xff\\xff\\xff\\x00\\xff\\xff\\xff\\xff\\xff\\xff\\xff\\xff\\xfe\\xff\\xff\\xff:/usr/bin/qemu-arm-static:OC' > /proc/sys/fs/binfmt_misc/register）。
•所有开发环境必须容器化或使用VM快照固化。同一份源码在不同终端、不同Shell配置下可能触发不同构建路径。推荐用Docker定义标准dev-env镜像（基于debian:bookworm-slim，预装指定版本gcc-arm-none-eabi、make、dtc等），每次启动即纯净一致，杜绝“在我机器上能跑”的协作障碍。