Sublime Text无法一键批量编译多个.asm文件，因其构建系统仅支持单文件（$file）；需借助外部脚本（如batch或Python）实现批量逻辑，Build System仅作调用入口。
Sublime Text 本身不支持“一键批量编译多个 .asm 文件”，它的构建系统（.sublime-build）默认只作用于当前活动文件（$file）。所谓“批量”，必须靠外部脚本或命令行工具驱动，编辑器只是触发入口。
为什么直接配置 Build System 无法真正批量编译
Sublime Text 的 cmd 或 shell_cmd 字段不支持通配符（如 *.asm）或循环逻辑。即使你写成 ["ml64", "*.asm"]，实际执行时会被 shell 当作字面量传给汇编器，而 ml64 或 ml 均不接受通配符输入 —— 它们会报错：error A2008: syntax error : * 或直接忽略。
常见误操作包括：
- 在
shell_cmd中硬写for %f in (*.asm) do ml64 %f：Windows cmd 不支持在单条shell_cmd里嵌套多行 for 循环，且 Sublime 不解析批处理语法 - 用
${file_path}/*.asm替换${file}：变量替换机制不展开 glob，结果是字面传递字符串，不是文件列表 - 依赖
variants实现“全部编译”：variant 只是不同命令变体，仍基于当前文件，无法切换目标
可行方案：用 batch/shell 脚本 + Build System 触发
核心思路是把“批量编译逻辑”下沉到外部脚本，Build System 只负责调用它，并确保工作目录正确。以 Windows + MASM64 为例：
在项目根目录下新建 build_all.bat：
cd /d "%~dp0"
for %%f in (*.asm) do (
echo Compiling %%f...
ml64 /c /Zi /Fo "%%~nf.obj" "%%f"
if errorlevel 1 exit /b 1
)
echo All ASM files compiled.
然后创建 ASM_Batch.sublime-build：
{
"shell_cmd": "build_all.bat",
"working_dir": "${project_path}",
"file_regex": "^(.*?\.[aA][sS][mM])\(([0-9]+)\): (.*)$",
"selector": "source.asm",
"encoding": "gbk"
}
要点说明：
-
working_dir必须设为${project_path}（而非${file_path}），否则脚本找不到build_all.bat或遍历不到目标文件 -
file_regex需匹配你实际汇编器的错误格式；ml64默认输出形如test.asm(12): error A2008: syntax error : eax，正则要能提取文件名和行号 - 脚本中使用
%~dp0确保路径稳定，避免因 Sublime 启动方式不同导致的 cwd 混乱 - 若用
ml（32 位）或UASM，只需替换脚本中的命令行，其余结构不变
更健壮的做法：用 Python 脚本替代 BAT
BAT 在跨平台、错误处理、日志控制上太弱。推荐用 Python 写 build_asm.py（放在项目根目录）：
import os
import sys
import subprocess
asm_files = [f for f in os.listdir('.') if f.lower().endswith('.asm')]
if not asm_files:
print("No .asm files found.")
sys.exit(0)
for f in asm_files:
print(f"Compiling {f}...")
result = subprocess.run(
["ml64", "/c", "/Zi", "/Fo", f"{os.path.splitext(f)[0]}.obj", f],
capture_output=True,
text=True,
encoding="utf-8"
)
if result.returncode != 0:
print(f"Error in {f}:
{result.stdout}
{result.stderr}")
sys.exit(1)
print("All done.")
对应 Build System 改为：
{
"cmd": ["python", "build_asm.py"],
"working_dir": "${project_path}",
"file_regex": "^(.*?\.[aA][sS][mM])\(([0-9]+)\): (.*)$",
"selector": "source.asm"
}
优势明显：
- 错误可精确捕获并打印，不会被 cmd 窗口一闪而过吞掉
- 容易加日志、跳过特定文件、并发编译（用
concurrent.futures） - 天然兼容 macOS/Linux（换用
nasm或gas即可） - 可读性高，后续维护成本低
真正卡住人的地方，从来不是“怎么写 build 文件”，而是没意识到 Sublime 的构建系统本质是「单文件代理」——它不管理项目，只响应当前标签页。批量动作必须交由更底层的工具完成，编辑器只管“按一下，跑起来”。
