sublime text 不能直接运行汇编代码，必须配置外部工具链（如nasm或ml.exe+link16.exe）并正确设置构建系统、语法高亮绑定及path环境变量，缺一不可。
Sublime Text 本身不运行汇编代码，必须靠你装好外部工具链（nasm 或 ml.exe + link16.exe）并正确配置构建系统，否则按 Ctrl+B 只会报错或静默失败。
确认 nasm / ml.exe 和链接器已可用
这是最常被跳过的一步，但所有后续配置都依赖它。Sublime 不检查、不提示、不帮你装——它只执行命令。
- 打开终端（Windows 建议用 CMD 或 PowerShell，不是 Git Bash），运行：
nasm -v（Linux/macOS/WSL）或ml.exe /?（Windows MASM）、link16.exe /?（16位 DOS 环境） - 如果提示
'nasm' is not recognized或command not found，说明 PATH 没配对，得先解决这个——不是 Sublime 的问题，是系统环境问题 - Windows 用户若用 MASM32，确保
D:masm32in（或你解压的实际路径）已加入系统Path环境变量；验证方式：新开一个 CMD 窗口再试ml.exe - macOS/Linux 用户推荐用
nasm+ld或gcc（gcc hello.o -o hello实际调用 ld），避免用过时的as/ld组合导致符号解析失败
手动绑定 .asm 文件到正确语法高亮
装了插件 ≠ 自动生效。.asm 或 .s 文件默认仍是 Plain Text，因为 Sublime 不自动关联后缀，必须手动“认领”一次。
- 打开任意
hello.asm文件 → 点右下角当前语言名（比如 “Plain Text”）→ 搜索NASM或x86 Assembly→ 选中对应项（如Assembly (NASM)） - 右键该文件标签 →
Open all with current extension as→ 再次选中刚才那个语法项（注意：.asm和.s是两个独立后缀，要分别绑） - 别信“重启就自动识别”——EnhancedAssembly、Assembly-x86 这类插件不会偷偷改你的后缀映射表，不点这一下，永远黑白一片
- 高亮不对？寄存器写成
eaxx都看不出，调试时多花三倍时间找拼写错误
写对 build system 的 shell_cmd 和 selector
构建系统文件（.sublime-build）里最容易出错的是 shell_cmd 路径、参数顺序和 selector 匹配失败。
-
selector必须和当前文件实际语法 scope 一致：如果是Assembly (NASM)，就写"selector": "source.nasm"；如果是x86 Assembly插件，常见的是"selector": "source.asm"——不匹配，Ctrl+B就根本不会触发这个构建系统 - Linux/macOS 示例（NASM + ld）：
"shell_cmd": "nasm -f elf64 $file -o ${file_base_name}.o && ld ${file_base_name}.o -o ${file_base_name}" - Windows MASM 示例（需 16 位 DOS 环境）：
"cmd": ["D:\masm32\bin\asm.bat", "$file_base_name"]，且asm.bat必须能访问ml.exe和link16.exe，路径不能含空格或中文 - 别漏掉
"encoding": "cp936"（Windows 中文环境）或"utf-8"（跨平台），否则中文注释或错误信息会乱码
运行前务必检查工作目录和入口符号
汇编比高级语言更敏感于路径和符号约定，尤其 16 位 DOS 或 Linux ELF 入口名不一致时，ld 直接报 undefined reference to `_start' 或 entry point not found。
- 确保
working_dir设为"${file_path}"，否则nasm找不到包含文件（%include）或生成的.o文件被丢到奇怪位置 - Linux x64 NASM 默认入口是
_start，不是main；写成global main会导致链接失败——得改成global _start - Windows MASM 默认入口是
_start或start，取决于你用的 linker，link16.exe通常要求end start对应的标号名 - 没加
-o输出选项？nasm默认生成out文件，不是.o，后续ld找不到输入对象
真正卡住人的往往不是语法或插件，而是 nasm 命令在终端能跑通，但 Sublime 构建系统里路径带空格、编码没设对、selector 拼错、或者入口符号和 linker 要求不一致——这些细节不验证，光看教程复制 JSON 是没用的。
