汇编文件构建系统必须禁用 shell 模式，默认“shell”: true 会通过 cmd/powershell 启动额外进程，显著增加开销；而 Windows 下 NASM/YASM 编译本身极快，对“改一行重编”场景尤为敏感。
汇编文件构建系统必须禁用 shell 模式
默认用 "shell": true 启动 cmd/powershell 会引入额外进程开销，对汇编这种“改一行就要重编”的场景尤为明显。Windows 下 NASM/YASM 编译本身极快（通常 Ctrl+B 响应从 300ms 降至 40ms 左右。
正确配置示例（以 NASM 为例）：
{
"cmd": ["nasm", "-f", "win64", "${file}", "-o", "${file_path}/${file_base_name}.obj"],
"file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$",
"working_dir": "${file_path}",
"selector": "source.asm, source.nasm",
"shell": false
}
-
"shell": false是关键，强制 Sublime 直接 fork 进程，绕过 shell 解析 -
file_regex要匹配 NASM 默认错误格式（如test.asm:5:1: error: invalid operand type），否则跳转不到报错行 - 避免在
cmd中用&&连接链接步骤——每次都要启动新进程；拆成独立构建变体更可控
Ctrl+B 编译前务必确认当前文件语法高亮为 Assembly (NASM)
Sublime 的构建系统通过 selector 匹配当前视图的语法类型。如果文件只是以 .asm 结尾，但手动选了 Plain Text 或 Assembly (GAS)，构建系统根本不会触发——你按 Ctrl+B 后控制台一片空白，连错误都不报。
检查与修复方法：
- 看窗口右下角状态栏，确认显示的是
Assembly (NASM)（不是Assembly或其他） - 若不对，点击该区域 → 选择
Open all with current extension as…→ 找到并固定为Assembly (NASM) - 确保
.asm文件关联正确：打开Preferences → Settings – Syntax Specific，确认"syntax": "Packages/Assembly/Assembly (NASM).sublime-syntax"
链接阶段必须分离为独立构建变体
汇编开发中，修改代码后常需反复编译+链接。把 nasm 和 link（或 gcc）写在同一 cmd 里，会导致每次 Ctrl+B 都强制重链接——哪怕只改了一条指令。而链接器（尤其是 Microsoft link.exe）比汇编器慢一个数量级。
推荐做法是定义两个变体：
"variants": [
{
"name": "Assemble Only",
"cmd": ["nasm", "-f", "win64", "${file}", "-o", "${file_path}/${file_base_name}.obj"]
},
{
"name": "Link Only",
"cmd": ["link", "/SUBSYSTEM:CONSOLE", "/ENTRY:main", "${file_path}/${file_base_name}.obj", "/OUT:${file_path}/${file_base_name}.exe"]
}
]
- 日常调试用
Ctrl+Shift+B→ 选Assemble Only，秒出 .obj - 确认汇编无误后再选
Link Only，避免无效链接 - 若用 MinGW-w64，
gcc可直接链接：["gcc", "-o", "${file_path}/${file_base_name}.exe", "${file_path}/${file_base_name}.o"]
中文路径和空格会直接导致 NASM 报 error: unable to open include file
NASM 对路径空格极其敏感，且不支持 Windows 的 Unicode 路径编码。如果你的项目在 C:\Users\张三\Projects\asm\ 下，即使路径本身合法，NASM 也大概率因宽字符或空格截断失败，错误信息却只显示找不到头文件。
根治办法只有两个：
- 把项目移到纯 ASCII 路径，例如
C:\asm\project\—— 这是最稳妥、零配置的方案 - 若必须用中文路径，改用 YASM 替代 NASM：
yasm -f win64 -g cv8 ${file} -o ${file_path}/${file_base_name}.obj，YASM 对路径兼容性更好 - 绝对不要在
cmd数组里用引号包裹路径（如"${file}"），Sublime 会自动处理，加引号反而触发 shell 解析，回到第一坑
汇编编译的瓶颈从来不在指令生成，而在路径解析、进程启动和构建逻辑耦合。把这三层剥清楚，Ctrl+B 就真能快过你敲回车的手速。
