交叉编译器需手动安装并验证，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 这类关键选项。