Sublime Text 需配置外部工具链（如 MASM32+DOSBox）和自定义 build system 才能编译汇编代码；高亮失效时应手动设置语法为 Assembly (NASM) 或 x86 (GAS)，并确保 build system 的 selector 与语法 scope 一致，路径须无空格，文件须先保存，且不支持调试与现代宏语法。
Sublime Text 本身不带汇编编译能力，必须靠外部工具链（如 MASM32 + DOSBox）配合自定义 build system 实现。直接按 Ctrl+B 肯定没反应——不是配置错了，是根本没连上汇编器。
怎么让 .asm 文件正确高亮？
右下角显示 Plain Text 就说明高亮失效，这不是插件没装，是 Sublime 没把文件当汇编处理：
- 点击右下角文字（比如
Plain Text），在弹出菜单里搜Assembly (NASM)、x86 (GAS)或x86 and x86 Assembly，选中即生效 - 如果菜单里没有这些选项，说明语法包被禁用：按
Ctrl+Shift+P→ 输入Package Control: Enable Package→ 启用EnhancedAssembly或MasmAssembly -
.asm和.s后缀要分开绑定：.s文件开头若有#行（如#include），Sublime 默认判为 ShellScript；需右键标签页 →Open all with current extension as…→ 手动指定为EnhancedAssembly → x86 (GAS) - 寄存器（如
eax）、指令（如mov）不着色？用Ctrl+Shift+P→Developer: Show Scope Name看输出是否含support.instruction——不含就是语法包没定义这个词，换主题（如Monokai）再试一次
为什么 build system 配置后仍不触发编译？
构建系统和语法高亮是两套机制，但共用同一个前提：文件必须被识别为汇编类型。常见断点如下：
-
selector字段必须与当前语法 scope 严格一致。例如你手动设为Assembly (NASM)，selector就得写"selector": "source.asm.nasm"；若设的是x86 and x86 Assembly，则应为"selector": "source.asm" - 路径含中文或空格会导致
ml.exe或link16.exe启动失败，报错类似'D:Program' is not recognized——务必把masm32和DOSBox安装到无空格路径（如D:masm32） - 环境变量只影响 cmd，不影响 Sublime 的 build system。不要依赖
Path中的masm32in，而应在.sublime-build中用绝对路径调用ml.exe - 文件保存后才可编译：
$file_base_name取的是文件名（不含扩展），若未保存，该变量为空，ml.exe /c .asm会报错
怎么写一个能编译 + 运行的 ASM.build？
以 MASM32 + DOSBox 组合为例（适用于 Win32 控制台或 DOS 模式程序），关键不是堆参数，而是控制执行流：
- 新建
D:masm32insm.bat，内容为：
@echo off D:masm32inml.exe /c %1.asm D:masm32inlink16.exe %1.obj %1,,,,, D:DOSBox-0.74DOSBox.exe %1.exe
- 在 Sublime 中新建 build system（
Tools → Build System → New Build System），填入：
{
"cmd": ["D:\masm32\bin\asm.bat", "$file_base_name"],
"file_regex": "^[ ]*File "(*?)", line ([0-9]*)",
"selector": "source.asm",
"encoding": "cp936",
"variants": [
{
"name": "Run_ASM",
"shell": true,
"cmd": ["D:\masm32\bin\asm.bat", "$file_base_name"]
}
]
}
- 保存为
ASM.sublime-build（路径自动为Packages/User/） - 注意：
link16.exe是 16-bit 链接器，仅支持 DOS 模式；若写 32-bit Windows 程序，要用link.exe并加/SUBSYSTEM:CONSOLE参数 - 该方案只支持单文件编译；多文件需在 bat 中遍历
.asm并调用ml.exe /c，最后统一link
容易被忽略的硬伤
这套流程能跑通“Hello World”，但别指望它替代 IDE：
-
ml.exe不支持现代语法（如.IF、.WHILE宏），遇到就报错；MASM32 SDK 本身已停止更新，Win10/11 下 DOSBox 兼容性也不稳定 - 错误定位靠
file_regex提取行号，但ml.exe输出格式不规范（比如提示error A2008: syntax error : mov却不带文件名），正则可能匹配失败，导致跳转不到出错行 - 没有调试支持：无法单步、看不到寄存器、不能设断点。所有运行都在 DOSBox 窗口里一闪而过，想看输出得加
pause或改用int 21h等待按键 -
.sublime-build里的shell_cmd和cmd在 Windows 上行为不同：前者走 shell（支持&&），后者走原生 API（不支持管道和逻辑连接符），混用会静默失败
