Sublime Text 配置32位汇编环境的关键是使用MASM32 SDK，正确设置include、lib和PATH环境变量，并通过shell_cmd调用build.bat脚本执行ml.exe和link.exe编译链接，编码需设为gbk，且ASM源码须符合MASM32语法规范。
Sublime Text 本身不自带汇编编译能力，配置 32 位汇编环境的关键是：用 MASM32（专为 Windows 32 位设计）+ 正确的环境变量 + 自定义 .sublime-build 文件。其他工具链（如 MinGW-w64、LLVM）默认不支持 MASM 语法，硬套会失败。
确认你用的是 MASM32，不是 NASM 或 FASM
Windows 下 32 位汇编主流就是 MASM32 SDK（含 ml.exe、link.exe、标准 include/lib）。它和 NASM（语法不同）、FASM（自包含）不兼容——别把 NASM 的 build 配置贴过来改个名就用。
-
ml.exe是 MASM32 的汇编器，必须在 PATH 中能直接调用 - 检查方法：cmd 中运行
ml /?，有帮助输出才算到位 - 如果只有
nasm.exe或fasm.exe，这条路走不通，得换工具链或重装 MASM32
环境变量必须设对，路径不能带空格或中文
MASM32 对路径敏感，尤其 include 和 lib 变量名是硬编码识别的（不是随便起的），PATH 里只放 bin 目录。
- 系统变量中新增：
include=E:\masm32\include（注意不是INCLUDE大写） - 系统变量中新增：
lib=E:\masm32\lib（同理，小写lib） - PATH 中追加：
E:\masm32\bin（确保ml.exe和link.exe可执行） - 改完务必重启 Sublime Text（不重启读不到新环境变量）
build 文件要调用 batch 脚本，不能直接 shell_cmd ml
ml.exe 依赖 include/lib 环境变量，且链接需多步（ml → link → 清理 .obj），直接写 "shell_cmd": "ml ..." 会报 “error A2008: syntax error” 或找不到 kernel32.inc。
- 在项目目录下建
build.bat，内容类似：
ml /c /coff "%~dpn1.asm" link /SUBSYSTEM:CONSOLE "%~dpn1.obj" kernel32.lib user32.lib
- Sublime 的
.sublime-build必须用shell_cmd调这个 bat，不能用cmd数组写法（Windows 下数组方式不继承环境变量） - 推荐 build 配置片段：
{
"shell_cmd": "build.bat \"${file_path}/${file_base_name}\"",
"file_regex": "^(..[^:]*):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "${file_path}",
"encoding": "gbk",
"selector": "source.asm"
}
-
encoding设gbk是因为 MASM32 默认用 GBK 读源码，UTF-8 注释会乱码
容易被忽略的细节：.asm 文件头和入口点
即使 build 成功，运行时报错“不是有效的 Win32 应用程序”或直接退出，大概率是代码没写对——MASM32 不接受现代风格的 main 入口。
- 必须用
.386+.model flat, stdcall开头 - 入口必须是
start:标签，且最后调ExitProcess（不是ret） - 示例最小可运行结构：
.386
.model flat, stdcall
option casemap :none
includelib \masm32\lib\kernel32.lib
ExitProcess PROTO STDCALL :DWORD
.code
start:
invoke ExitProcess, 0
end start
- 少任意一行（比如缺
includelib或PROTO声明），link都会失败
