交叉编译器需手动安装并验证，sublime仅调用外部工具链；构建系统必须显式指定arm-linux-gnueabihf-gcc等带前缀命令，路径含空格或中文时变量须转义加引号，shell:true不可省略，输出面板不支持交互式输入，调试需借助gdb+openocd。
交叉编译器必须独立安装，Sublime 不提供也不封装任何工具链
Sublime Text 本身是纯文本编辑器，没有编译能力，更不会自带 arm-linux-gnueabihf-gcc 这类交叉编译器。所谓“配置交叉编译环境”，本质是让 Sublime 的构建系统（Build System）调用你**手动安装并验证过的交叉工具链**。如果 arm-linux-gnueabihf-gcc --version 在终端报错或提示“command not found”，那 Sublime 再怎么配都跑不起来。
- Windows 用户：推荐从 ARM GNU Toolchain 官网 下载预编译包，解压后把
bin/目录加进系统PATH - Linux/macOS 用户：可用
apt install gcc-arm-linux-gnueabihf（Ubuntu/Debian）或brew install arm-gcc-bin（macOS + Homebrew），但务必验证命令是否可执行 - 验证方式统一：打开终端，运行
arm-linux-gnueabihf-gcc --version和arm-linux-gnueabihf-objdump --help，两项都成功才代表工具链就绪
构建系统里不能只写 gcc，必须显式指定交叉编译器前缀
默认的 C 构建配置里写的是 ["gcc", "$file_name", "-o", "$file_base_name"]，这只会调用本机 gcc，完全无法生成目标平台二进制。你需要把所有编译、链接、甚至后续的 objdump 或 size 工具，全部换成带前缀的版本。
- 基础编译配置示例（保存为
ARM_C.sublime-build）：{ "cmd": ["arm-linux-gnueabihf-gcc", "$file_name", "-o", "$file_base_name", "-static"], "selector": "source.c", "shell": true, "working_dir": "$file_path", "variants": [ { "name": "Run", "cmd": ["arm-linux-gnueabihf-gcc", "$file_name", "-o", "$file_base_name", "-static", "&&", "qemu-arm", "./$file_base_name"] }, { "name": "Size", "cmd": ["arm-linux-gnueabihf-size", "$file_base_name"] } ] } -
"shell": true必须保留，否则&&和管道符会失效 - 如需调试，可额外加
-g -O0；嵌入式常用-static避免动态库依赖问题
中文路径或空格会导致构建失败，$file_path 要加引号才安全
当源文件路径含中文、空格或括号（比如 D:\嵌入式项目\hello.c），未加引号的 $file_path 会被 shell 拆成多个参数，报错类似 arm-linux-gnueabihf-gcc: error: 项目\hello.c: No such file or directory。这不是交叉编译器的问题，是 Sublime 构建系统传参时的常见陷阱。
- 正确写法：把所有含路径的变量用双引号包裹，例如：
"arm-linux-gnueabihf-gcc" "$file_name" -o "$file_base_name" - 注意：JSON 中字符串本身已有外层双引号，所以内部引号要转义为
\"，即："cmd": [\"arm-linux-gnueabihf-gcc\", \"$file_name\", \"-o\", \"$file_base_name\"] - 更稳妥做法：统一使用
shell_cmd字段替代cmd，直接写 shell 命令行，避免数组解析歧义
运行结果看不到？别指望输出面板支持交互，得靠 QEMU 或真机部署
Sublime 的内置输出面板只能捕获程序 stdout/stderr，不支持 stdin 输入，也无法模拟串口、LED 控制等嵌入式典型行为。如果你写了 scanf 或等待 UART 数据，按 Ctrl+B 后会卡住——这不是配置错了，是能力边界问题。
- 快速验证编译产物：用
qemu-arm ./hello在宿主机模拟运行（需提前装好 QEMU） - 真机部署流程不在 Sublime 范围内：构建系统可追加
scp或rsync命令，但建议拆到 Makefile 或脚本中管理 - 想看寄存器/内存状态？得用 OpenOCD + GDB，这类调试必须脱离 Sublime，用终端或 VS Code 等专用前端
arm-linux-gnueabihf-gcc 输出的 ELF 头、ABI、C 库链接方式都和本地 gcc 不同，Sublime 只负责“叫它干活”，干得对不对、结果能不能跑，全取决于你装的工具链是否匹配目标芯片，以及构建参数有没有漏掉 --sysroot 或 -march 这类关键选项。
