Sublime Text 的 Build System 默认只处理当前文件，无法直接运行整个文件夹；需通过自定义 shell 命令遍历目录或编写 Python 插件实现多文件执行。
为什么不能直接用 Build System 运行整个文件夹
Sublime Text 的 Build System 默认只作用于当前打开的文件，不是目录。你点“Build”时，它根本不知道你想要跑整个文件夹——它连“当前文件夹”这个概念都没有，除非你显式告诉它路径和执行逻辑。
常见错误现象：Unable to find target 或命令直接报错说找不到文件，本质是 build system 没传对路径，或者 shell 里没做遍历。
- Build System 是单文件上下文，不自动感知项目根目录或同级脚本
-
working_dir只影响命令执行时的 cwd，不改变要运行的文件列表 - Windows 下用
cmd、macOS/Linux 用bash，通配符（如*.py）行为不一致，尤其 Windows cmd 不支持for *.py直接展开
用 Shell Command + 自定义 Build System 遍历运行
核心思路：写一个能识别当前文件所在目录、再用 shell 命令遍历执行同目录下匹配脚本的 build system。关键是把 $file_path 提取为目录，并在该目录下执行循环。
以 Python 脚本为例（其他语言只需改后缀和解释器）：
{
"shell_cmd": "cd \"$file_path\" && for f in *.py; do [ -f \"$f\" ] && python \"$f\"; done",
"working_dir": "$file_path",
"selector": "source.python"
}
说明：
-
$file_path是 Sublime 内置变量，值为当前文件所在目录（不含文件名），可直接用于cd -
[ -f \"$f\" ]是必须的——防止*.py无匹配时字面量展开成*.py字符串，导致python *.py报错 - macOS/Linux 用
bash支持for；Windows 用户需改用cmd语法：cd /d \"%FILE_PATH%\" && for %f in (*.py) do @if exist \"%f\" python \"%f\" - 注意 Windows 中
%FILE_PATH%和%f是 cmd 变量，不能混用$符号
如何避免重复弹窗或阻塞编辑器
默认 build 输出会阻塞 UI，且每个脚本执行完都弹一次结果面板——10 个脚本就弹 10 次，体验极差。关键控制点在输出方式和并发行为。
- 加
2>&1合并 stderr 到 stdout，避免部分错误被吞掉 - 用
echo === $f ===做分隔，方便定位哪个脚本出问题 - 不要用
start（Windows）或&（Unix）后台运行——会导致输出乱序、无法捕获异常、Sublime 无法正确标记失败 - 如果某脚本卡住，整个 build 就挂起；建议脚本自身加超时（如 Python 用
signal.alarm），或改用外部任务调度工具（如make或just）处理复杂场景
更可靠的做法：用 Python 构建插件替代 Build System
Build System 天然不适合多文件协调任务。真正稳定的方式是写一个 Sublime 插件，用 Python API 获取当前视图所在文件夹，再用 subprocess.run 顺序执行，还能统一捕获返回码、超时、编码。
最小可行插件示例（保存为 RunFolderScripts.py 到 Packages/User/）：
import sublime
import sublime_plugin
import subprocess
import os
class RunFolderScriptsCommand(sublime_plugin.TextCommand):
def run(self, edit):
folder = os.path.dirname(self.view.file_name())
py_files = [f for f in os.listdir(folder) if f.endswith('.py')]
for f in py_files:
path = os.path.join(folder, f)
res = subprocess.run(['python', path], capture_output=True, text=True, cwd=folder)
print(f"=== {f} ===\n{res.stdout}{res.stderr}")
然后绑定快捷键：
{ "keys": ["ctrl+alt+r"], "command": "run_folder_scripts" }
优势：
- 跨平台路径处理由 Python 标准库保证，不用手写 shell 兼容逻辑
- 可精确控制超时（
timeout=30）、环境变量、编码 - 输出统一打印到 Sublime 控制台，不干扰 build panel
- 能响应取消操作（虽然需要额外加线程管理，但结构上可扩展）
真正麻烦的从来不是“怎么跑”，而是“跑挂了怎么知道是哪个挂了、挂多久了、要不要继续”。这些细节 build system 很难兜住，得靠插件层收口。
