由 dawei 嵌入式Linux开发高度依赖稳定、可控的Unix-like环境，但新手常因环境配置失当导致编译失败、工具链异常或调试中断。避开常见陷阱，比盲目堆砌工具更重要。
创意图AI设计，仅供参考
宿主机操作系统首选Ubuntu LTS或Debian稳定版，避免使用Fedora、Arch等滚动更新发行版——内核头文件、glibc版本与交叉工具链的兼容性易被突然升级破坏。不要在WSL1上搭建完整构建环境，其缺乏真正的POSIX信号支持和完整的/proc/sys/fs/inotify限制，会导致bitbake或Yocto构建中途崩溃。
交叉编译工具链务必采用厂商官方预编译包（如ARM官方GNU Toolchain或NXP提供的LSDK），禁用apt install gcc-arm-linux-gnueabihf等系统包管理器安装的工具链。后者常混用主机libc头文件，引发“undefined reference to `__errno_location`”等隐蔽链接错误。
环境变量设置须严格隔离：不要将交叉工具链路径写入全局/etc/environment或~/.profile，而应在项目目录下使用专用脚本（如setup-env.sh）通过source加载，并显式unset HOST_类冲突变量。PATH中工具链bin目录必须置于/usr/bin之前，且禁止包含主机gcc所在路径。
文件系统权限是静默杀手：NFS挂载的开发根文件系统若启用no_root_squash但客户端UID不匹配，会导致mknod失败、systemd无法启动；使用rsync同步rootfs时，必须加-aH选项保留硬链接与权限，否则udev规则丢失、设备节点无法生成。
Shell选择有讲究：默认使用bash而非zsh或fish——Buildroot与Yocto的Makefile和shell脚本大量依赖bash特有语法（如$(( ))算术扩展、[[ ]]测试命令），切换shell后出现“unexpected token”错误却难以定位。
日志与调试工具要轻量闭环：避免直接部署full-featured gdbserver，改用gdb-multiarch + qemu-user-static组合做用户态仿真；串口调试优先用screen或picocom，而非minicom——后者默认启用硬件流控，在多数开发板上引发接收丢帧，表现为console输出断续或命令无响应。