由 dawei 嵌入式Linux开发高度依赖稳定、可控的Unix环境，但新手常因忽略细节导致构建失败或调试受阻。避免在宿主机上直接用系统默认包管理器安装交叉工具链——Ubuntu/Debian的gcc-arm-linux-gnueabihf版本陈旧，且与Yocto或Buildroot要求不兼容；务必从Linaro官网或工具链厂商（如Arm GNU Toolchain）下载匹配目标架构的预编译二进制包，并解压至独立路径（如~/tools/arm-gnu/），避免污染系统/usr目录。
环境变量配置是高频出错点：不要在~/.bashrc中仅用export PATH=“$PATH:/path/to/toolchain/bin”，这会导致路径重复累积，引发命令混淆；应先判断路径是否已存在，再追加；推荐使用profile.d机制，在/etc/profile.d/embedded-env.sh中统一定义ARCH、CROSS_COMPILE等变量，并设CROSS_COMPILE=arm-linux-gnueabihf-（结尾含短横线），确保Makefile识别正确。
文件系统权限常被忽视：NFS挂载嵌入式根文件系统时，若宿主机用户UID/GID与目标板不一致，chown操作会静默失败；务必在启动NFS服务前，在/etc/exports中添加no_root_squash选项，并用id命令核对双方UID；对于ext4镜像制作，避免用sudo make_ext4fs直接打包，而应使用e2tools或debugfs检查inode权限，防止/dev/console等关键设备节点缺失。
AI绘图结果，仅供参考
Shell兼容性陷阱隐蔽性强：开发脚本习惯用#!/bin/bash特性（如数组、[[ ]]），但BusyBox ash或Dash默认为/bin/sh；编译内核或U-Boot时若出现“syntax error near unexpected token”即为此因；所有构建脚本首行需明确指定#!/bin/bash，且在Buildroot配置中启用BR2_SHELL_BASH选项；临时切换可执行sh –version确认当前shell类型。
串口终端乱码多源于minicom或picocom未正确设置硬件流控：多数ARM评估板不支持RTS/CTS，必须手动禁用；运行picocom -b 115200 –no-hwflow /dev/ttyUSB0，切忌依赖保存的配置文件，每次连接前用stty -F /dev/ttyUSB0查看实际参数。同时关闭systemd-journald的串口输出干扰：在/boot/extlinux/extlinux.conf中添加console=tty1 console=ttyS0,115200n8，避免日志抢占控制台。