由 dawei 嵌入式Linux开发高度依赖稳定、可控的Unix-like环境，但新手常因环境配置失当导致编译失败、工具链异常或调试中断。避开常见陷阱，比盲目堆砌工具更重要。
避免在Windows子系统（WSL1）上构建完整嵌入式工具链。WSL1缺乏完整的Linux内核接口，无法运行QEMU全系统模拟，也难以调试内核模块和驱动。如需Windows平台，优先选用WSL2，并确保启用systemd支持（通过修改/etc/wsl.conf），否则systemd服务类构建脚本会静默失败。
不要直接使用发行版默认的交叉编译工具链。Ubuntu/Debian的gcc-arm-linux-gnueabihf等包版本陈旧，且不提供对ARMv8-A AArch64或RISC-V 64-bit等新兴架构的完整支持。推荐从bootlin.com下载预编译的、带glibc和debug信息的可靠工具链，或使用crosstool-ng按需定制，避免因libc版本错配导致运行时符号未定义。
忽略shell兼容性会引发隐性错误。Makefile和构建脚本常隐含假设/bin/sh指向bash，但Debian/Ubuntu默认dash极简shell不支持数组、[[ ]]等语法。务必在脚本首行明确写#!/bin/bash，并在Makefile中用SHELL := /bin/bash显式指定，防止CI环境或Docker容器中莫名报错。
AI渲染图，仅供参考
文件系统权限与挂载选项不可轻视。NFS或ext4挂载若启用noexec、nosuid或nodev，将导致交叉编译生成的临时可执行文件无法运行，甚至configure检测失败。开发分区建议使用defaults（含exec、suid）挂载；若必须使用noexec，则将build目录置于/tmp或独立可执行挂载点。
忽视时区与locale可能导致git提交编码混乱、日志时间错乱，或Python构建脚本因LANG=C.UTF-8缺失而抛UnicodeError。安装系统后立即执行sudo dpkg-reconfigure locales，勾选en_US.UTF-8与对应中文locale，并在~/.profile中设置export LANG=en_US.UTF-8，避免后期排查低级字符问题耗费数小时。
工具链路径污染是高频雷区。多个toolchain/bin目录被反复追加进PATH，易造成gcc、ld版本混用。建议用direnv管理项目级环境：在项目根目录创建.envrc，写入PATH_add ./tools/arm-toolchain/bin，并执行direnv allow。退出目录自动还原PATH，彻底杜绝误调用。