最常卡在语法未绑定和nasm/as命令不在PATH：右下角为Plain Text需手动选Assembly (NASM)或x86 (GAS)，.s与.S须分别绑定；Ctrl+B报命令未找到则需确认nasm -v终端可运行，并将路径加入系统PATH且Sublime从终端启动。
Sublime Text 新手配汇编编译系统，最常卡在两件事上：一是代码打开全是黑白（Plain Text），二是按 Ctrl+B 直接报 sh: nasm: command not found 或 ‘as’ is not recognized。这不是插件没装好，而是语法绑定和构建系统完全没对上——先解决这两个，再谈“能编”。
为什么 .asm / .s 文件打开就是 Plain Text？
Sublime 不会自动把后缀和语法关联起来，哪怕你装了 NASM Assembly 插件。它只查内置映射表，而默认表里基本不包含 .asm、.s、.S 这些扩展名。
- 点编辑器右下角当前语言名（比如
Plain Text）→ 搜索NASM或x86 (GAS)→ 手动选中 - 如果菜单里压根没有这些选项，说明插件被禁用了：按
Ctrl+Shift+P→ 输入Package Control: Enable Package→ 搜Assembly (NASM)或GNU Assembly (GAS)→ 勾选启用（注意括号和大小写） -
.s和.S是两个独立后缀，必须分别绑定：右键标签页 →Open all with current extension as…→ 选对应语法；.s默认常被误判为 Shell，尤其开头有#注释时
怎么写一个能跑通的 ASM 构建系统？
构建系统本质是告诉 Sublime：“用什么命令、在哪儿执行、怎么解析错误行”。它和语法高亮无关，但 selector 字段必须和当前文件实际语法 ID 完全一致，否则 Ctrl+B 根本不会触发这个构建系统。
- 按
Ctrl+Shift+P→ 输入Build System: New Build System→ 粘贴以下内容（以 NASM + Windows 为例）：
{
"cmd": ["nasm", "-f", "win64", "${file}", "-o", "${file_path}/${file_base_name}.obj", "&&", "link", "/subsystem:console", "${file_path}/${file_base_name}.obj", "/out:${file_path}/${file_base_name}.exe"],
"file_regex": "^(.*?):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "${file_path}",
"selector": "source.asm",
"shell": true
}
-
selector必须匹配你当前文件的语法 ID：打开一个已正确高亮的.asm文件 →Ctrl+Shift+P→ 输入Developer: Show Scope Name→ 看输出最前面是不是source.asm；如果是source.nasm或别的，就改成对应值 - Mac/Linux 用户把
nasm换成as或gcc，路径别硬编码，确保nasm -v在终端能运行；Sublime 启动方式影响 PATH 继承（Mac 推荐从终端执行subl .启动） - 保存为
ASM.sublime-build，然后通过Tools → Build System选中它
nasm / as 命令找不到怎么办？
这不是 Sublime 的错，是系统根本没暴露编译器给它。Windows 报 'nasm' is not recognized，Mac 报 sh: nasm: command not found，都是同一类问题。
- 先在终端/命令行确认：输入
nasm -v或as --version能输出版本号才算到位 - Windows：把
nasm.exe所在目录（如C:\nasm\）加进系统环境变量PATH，不是用户 PATH，是系统 PATH（避免某些杀软拦截） - Mac（Apple Silicon）：Homebrew 安装的
nasm默认在/opt/homebrew/bin/nasm，必须从终端启动 Sublime（subl .），否则它看不到这个路径 - Linux：确认
sudo apt install nasm或pacman -S nasm已执行，且which nasm有输出
真正容易被忽略的是：selector 和语法 scope 必须严丝合缝，差一个字符（比如 source.asm 写成 source.nasm）就会静默失效；而 PATH 问题在 GUI 启动 Sublime 时极难排查——它不会报错，只是构建直接跳过。这两点不先钉死，后面调任何参数都没用。
