交叉编译器必须预先安装并配置到系统PATH中，Sublime仅调用已有命令；需验证arm-linux-gnueabihf-gcc和objdump等工具均可用，构建命令须全部使用带前缀的交叉工具链，并正确处理路径空格、shell解析及多模块工程的working_dir与selector配置。
交叉编译器必须先在系统终端可用，Sublime 不会帮你装
Sublime Text 本身不提供、不封装、也不下载任何交叉编译器。如果你的终端里运行 arm-linux-gnueabihf-gcc --version 报 command not found，那 Sublime 再怎么配都跑不起来——它只是调用你已有的命令。
验证必须做全：arm-linux-gnueabihf-gcc --version 和 arm-linux-gnueabihf-objdump --help 都得成功返回，才算工具链就绪。
- Windows 用户：从 ARM GNU Toolchain 官网下载预编译包，解压后把
bin/目录加进系统PATH - Linux（Ubuntu/Debian）：运行
sudo apt install gcc-arm-linux-gnueabihf，但注意检查是否真装上了带前缀的命令（有些发行版默认只装gcc-arm-linux-gnueabi） - macOS：用
brew install arm-gcc-bin，然后确认which arm-linux-gnueabihf-gcc能输出路径
构建系统里所有工具都得带交叉前缀，不能只改 gcc
默认 C 构建系统里写 ["gcc", "$file_name", "-o", "$file_base_name"] 是无效的——它调的是本机 gcc，生成的是 x86_64 可执行文件，不是 ARM 目标码。
你得把每个环节都换成带前缀的版本：编译、链接、objdump、size、甚至 strip，否则构建可能“成功”，但产物根本没法在目标板上跑。
-
"cmd": ["arm-linux-gnueabihf-gcc", "$file_name", "-o", "$file_base_name", "-static"]—— 加-static避免目标板缺动态库 - 如果要用
objdump查看符号，变更为["arm-linux-gnueabihf-objdump", "-d", "$file_base_name"] - 不要混用：比如用本机
gcc编译 + 交叉objdump，会导致架构不匹配报错
路径含空格或中文时，$file_path 必须加引号，且 shell:true 不可省
像 D:\嵌入式项目\main.c 或 /home/user/my project/src/main.c 这类路径，若不加引号直接传给 shell，会被拆成多个参数，报错类似：arm-linux-gnueabihf-gcc: error: 项目\main.c: No such file。
"shell": true 是关键开关：它让 Sublime 用 /bin/sh（Linux/macOS）或 cmd.exe（Windows）来解析命令，才能支持 &&、管道、引号包裹等 shell 特性。
- 正确写法：
"cmd": ["arm-linux-gnueabihf-gcc", "\"$file\"", "-o", "\"$file_base_name\"", "-static"] - 更稳妥的做法是统一用
shell_cmd字段（尤其 Windows 下）："shell_cmd": "arm-linux-gnueabihf-gcc \"$file\" -o \"$file_base_name\" -static" - Mac/Linux 用户若用
zsh，确保shell_cmd中的引号能被正确转义；Windows 用户建议用cmd /c包裹
多语言多模块工程靠 selector + variants + working_dir 协同控制
一个嵌入式项目常含 C、Python（用于 host 工具）、Makefile、甚至 Device Tree Source（.dts），不能只靠一个构建系统硬扛。关键是用 selector 触发不同语言，再用 variants 提供同一语言下的不同动作（如 build / flash / dump）。
working_dir 决定命令执行位置——对多模块工程尤其重要。比如顶层 Makefile 在项目根目录，而 C 源码在 src/ 子目录，不设 working_dir 就会找不到头文件或链接脚本。
- C 模块：设
"selector": "source.c"，"working_dir": "$project_path"（假设项目根有 Makefile） - Python host 工具：另建
Host_Python.sublime-build，"selector": "source.python"，"working_dir": "$file_path"（单独运行脚本） - Flash 固件：在 C 构建系统的
variants里加一项："name": "Flash", "shell_cmd": "openocd -f interface/jlink.cfg -f target/stm32f4x.cfg -c \"program $file_base_name.bin verify reset exit\""
真正容易被忽略的是：Sublime 的 $project_path 只在打开整个文件夹（而非单个文件）时才有效；如果只开一个 .c 文件，$project_path 为空，working_dir 就会退化为 $file_path，导致 make 找不到顶层配置。
