Sublime Text 不自带汇编编译系统，需手动创建 .sublime-build 文件并正确配置语法绑定、PATH 环境、selector 和命令；必须先确认 nasm/as/gcc -S 已安装且终端可调用，再匹配文件后缀与语法（如 .asm→NASM、.s→GAS），否则构建不触发。
Sublime Text 本身不生成汇编编译系统，它只负责调用你系统里已有的 nasm、as 或 gcc -S 这类工具。所谓“生成”，其实是手动创建一个 .sublime-build 文件，告诉 Sublime：在什么语法下、用什么命令、在哪个工作目录里去跑汇编器。
确认汇编器已安装且可在终端调用
这是最常被跳过的前置步骤，也是 Ctrl+B 报 sh: nasm: command not found 的根本原因：
- 先在系统终端（不是 Sublime 内置终端）执行
nasm -v或as --version，必须能输出版本号 - Windows 用户检查
nasm.exe所在路径是否加入系统PATH（推荐 MSYS2 的mingw64/bin或独立 NASM 安装目录） - macOS 用户若用 Homebrew 安装，路径通常是
/opt/homebrew/bin/nasm；必须从终端启动 Sublime（如subl .），否则它看不到这个 PATH - Linux 用户确认
sudo apt install nasm binutils或对应包已装全
手动绑定文件后缀到正确语法（高亮前提）
右下角显示 Plain Text 就说明高亮没启动，构建系统也永远不会触发——因为 Sublime 根本不认为这是汇编文件：
- 打开一个
hello.s→ 点右下角Plain Text→ 搜索x86 (GAS)并选中（AT&T 语法） - 打开一个
hello.asm→ 同样点右下角 → 搜索Assembly (NASM)并选中（Intel 语法） - 若菜单里没有这些选项，按
Ctrl+Shift+P→ 输入Package Control: Enable Package→ 启用EnhancedAssembly或NASM Assembly -
.s和.S是两个独立后缀，必须分别右键标签页 →Open all with current extension as…→ 单独绑定（内核汇编常用.S）
创建匹配语法的构建系统（selector 必须严格一致）
构建系统里的 selector 字段不是随便写的，它必须和当前文件实际激活的语法 scope 完全一致，否则 Build 菜单里压根不显示该选项：
- 用
Assembly (NASM)时，selector应为source.asm.nasm（查法：Ctrl+Shift+P→Developer: Show Scope Name） - 用
EnhancedAssembly → x86 (GAS)时，selector应为source.gas - 基础 NASM 构建示例（保存为
NASM.sublime-build）：
{
"cmd": ["nasm", "-f", "elf64", "${file}", "-o", "${file_path}/${file_base_name}.o"],
"file_regex": "^(.*?):([0-9]+):?([0-9]+)?:? (.*)$",
"working_dir": "${file_path}",
"selector": "source.asm.nasm",
"variants": [
{
"name": "Link and Run",
"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", "&&", "${file_path}/${file_base_name}"]
}
]
}
- 注意：
shell字段默认为false，Linux/macOS 下多命令需显式加"shell": true；Windows 下建议用shell_cmd配合cmd /c
调试符号与中文路径问题（容易忽略的坑）
即使构建成功，也可能遇到链接失败或运行无输出，根源常藏在细节里：
- 汇编文件含中文路径或文件名？
nasm默认不支持 UTF-8 路径，Windows 下尤其易报错；临时解法：把项目移到纯英文路径（如C:/asm/） - 想用
gdb调试？NASM 需加-g参数，且目标格式得支持调试信息（-f elf64可以，-f win64在 Windows 上可能不行） - 构建后生成的
.o文件未清理？下次编译可能链接旧目标，导致行为异常；建议在variants中加清理步骤："cmd": ["rm", "-f", "${file_path}/${file_base_name}.o"] - 使用
gcc -S生成汇编时，注意它输出的是 AT&T 语法，别拿 NASM 构建系统去跑
