由 dawei 嵌入式Linux开发高度依赖稳定、可控的Unix-like环境，但新手常因环境配置失当导致编译失败、工具链异常或调试中断。避开常见陷阱，比盲目堆砌工具更重要。
宿主机操作系统首选Ubuntu LTS或Debian稳定版，避免使用Fedora、Arch等滚动更新发行版——内核头文件、glibc版本与交叉工具链的兼容性易被突然升级破坏。若必须用macOS，切勿依赖Homebrew默认安装的GNU工具链，需明确指定–with-sysroot并验证/bin/sh是否为dash而非zsh，否则Makefile解析可能出错。
交叉编译工具链务必从芯片原厂（如ARM官方GNU Toolchain、NXP SDK）或Linaro官方镜像获取预编译包，禁用apt install gcc-arm-linux-gnueabihf一类“黑盒”包。这类包常隐藏sysroot路径差异和浮点ABI配置（hard/soft），引发运行时SIGILL或浮点运算错误。
环境变量设置须严格隔离：PATH仅包含交叉工具链bin目录，不可混入宿主gcc；SYSROOT必须指向工具链内精确匹配的target sysroot，而非Linux内核源码目录或buildroot输出路径。临时修改PATH后务必用which arm-linux-gcc和arm-linux-gcc -v双重验证。
文件系统构建阶段，慎用QEMU-user-static直接chroot进目标根文件系统——部分嵌入式SoC的特定指令（如ARM VFP扩展）在用户态模拟下静默失效。推荐用buildroot或Yocto生成完整镜像后，在真实QEMU系统模式中启动验证。
调试环节避免过度依赖GDB server网络调试。内核崩溃日志（dmesg）常因串口波特率不匹配、earlyprintk未启用而丢失关键信息。务必在u-boot中统一设置console=ttyS0,115200n8与内核cmdline一致，并在defconfig中显式启用CONFIG_DEBUG_KERNEL和CONFIG_LOG_BUF_SHIFT=18。
AI生成内容图，仅供参考
•所有环境配置脚本必须版本化管理。一份可重复执行的setup.sh，比零散的博客命令片段更可靠——它应检查glibc最小版本、确认/bin/sh符号链接指向dash、校验工具链MD5，并在失败时退出而非继续执行。