Sublime中汇编文件的selector必须与实际语法scope严格一致：打开文件后用“Show Scope Name”查看，如source.nasm或source.gas；不可写source.asm或source.s，因这些scope不存在。
汇编文件的 selector 怎么写才匹配 .asm / .s
Sublime 不识别 .asm 或 .s 为默认汇编语法，直接写 "selector": "source.asm" 会失效——它根本不存在。真实可用的作用域名得靠“查”：打开一个汇编文件 → 右键 → Developer → Show Scope Name，顶部状态栏会显示类似 source.nasm（NASM）、source.gas（GNU Assembler）或 source.masm（MASM）。不同插件注册的 scope 名完全不同。
实操建议：
- 优先安装
NASM Syntax或GNU Assembly插件（通过 Package Control），再查 scope 名 - 若只用基础语法高亮，可退而求其次用
"selector": "source | text"，但需在shell_cmd中手动判断后缀 - 避免写
"selector": "source.asm"或"source.s"—— 这些是常见误解，Sublime 内部无此 scope
多文件编译必须用 Makefile，不能只靠 $file
$file 变量永远只指向当前激活标签页的单个文件，对汇编项目毫无意义。你写 main.asm 依赖 utils.asm 和 io.asm，仅编译 main.asm 会报 undefined symbol 错误，因为链接阶段缺失其他目标文件。
正确做法是把构建逻辑交给 make，由 Makefile 控制依赖与顺序：
- Makefile 必须显式声明所有
.o文件依赖对应的.asm，例如：main.o: main.asm utils.o io.o - 构建系统里
"cmd"改成["make"]，而不是["nasm", "-f", "elf64", "$file"] -
"working_dir"必须设为 Makefile 所在目录（通常是项目根目录），否则make找不到规则 - Windows 用户若用
mingw32-make，cmd得写成["mingw32-make"]，不能混用
NASM + ld 多文件链接时的路径与空格陷阱
汇编项目常含中文路径或空格（如 D:\课程设计\os-kernel\boot.asm），直接拼接命令会导致 nasm 报 “no input files” 或 ld 找不到 .o 文件——因为未加引号的路径被 shell 拆成了多个参数。
关键配置项：
- 必须启用
"shell": true，否则&&、引号、变量替换均不生效 - 所有含变量的路径都得用双引号包裹：
"shell_cmd": "nasm -f elf64 \"${file}\" -o \"${file_path}/${file_base_name}.o\" && ld -o \"${file_path}/${file_base_name}\" \"${file_path}/${file_base_name}.o\"" - 若用 Makefile，则在 Makefile 内部用
$(abspath ...)或$(shell pwd)处理路径，比在 .sublime-build 里硬编码更可靠 - Linux/macOS 下确保
nasm和ld在 PATH 中；Windows 下若 MinGW 的ld不兼容 NASM 输出，改用gcc做链接器：gcc -nostdlib -o ... *.o
调试符号和 objdump 查看反汇编要同步开启
汇编调试不像 C 那样有行号映射，但 nasm -g 生成的 DWARF 信息能让 gdb 显示源码行、设置断点。如果构建系统没传 -g，gdb 会退化成纯寄存器/指令级调试，效率极低。
配套动作不能少：
- Makefile 里所有
nasm命令加-g -F dwarf（NASM 2.15+ 默认格式） - 链接时保留调试段：
ld -o kernel.bin kernel.o --strip-all会删掉调试信息，应去掉--strip-all - 想快速查看生成的机器码，加个
variants调用objdump：{"name": "Disasm", "cmd": ["objdump", "-d", "${file_path}/${file_base_name}"]} - 注意
objdump版本：交叉环境要用带前缀的，如arm-linux-gnueabihf-objdump，否则架构不匹配
真正卡住人的不是语法，而是 scope 名查错、Makefile 依赖漏写、路径没引号这三处。一旦跑通一个最小可运行的 main.asm + Makefile + .sublime-build 组合，后续扩展就只是复制粘贴加修改。
