Sublime Text 不支持一键运行多文件项目，因其构建系统仅处理当前文件；可行方案包括：①用shell脚本封装入口并配置对应Build System；②编写Python自举脚本驱动执行；③借助Terminus插件实现交互式运行。
Sublime Text 本身不支持“一键运行多文件项目”，它只运行当前活动标签页的单个文件；所谓“项目运行”必须靠外部脚本或构建系统手动聚合，否则 Ctrl+B 永远只作用于 $file —— 这是核心限制，不是配置问题。
为什么 build system 无法直接运行整个项目
Build System 的 cmd 或 shell_cmd 只接收预定义变量（如 $file、$file_path），不提供“当前项目所有 .py 文件”这类集合变量；selector 仅用于激活构建系统，不触发多文件扫描；Project 设置里的 build_system 字段也只指定默认构建器，不改变执行目标。
- 试图在
cmd里写["python", "*.py"]会报错：操作系统找不到名为*.py的文件 -
working_dir设为"$project_path"也没用——Sublime 不会自动遍历该目录下所有源码并执行 - 即使你用
shell_cmd调用find . -name "*.py" -exec python {} ;，也会因输出混杂、错误定位失效、stdin 阻塞等问题不可控
真正可行的三种替代方案
绕过 Sublime 原生限制，需借助外部协调层：
-
用 shell 脚本封装项目入口：在项目根目录写
run.sh（Linux/macOS）或run.bat（Windows），内容为实际启动逻辑（如python main.py或python -m mypackage），再配一个 Build System 指向该脚本：["bash", "$project_path/run.sh"] -
用 Python 自举脚本驱动：写一个
launch.py，用subprocess.run()依次调用各模块，设其为cmd目标；注意加-u参数并捕获 stderr，否则错误被吞 -
改用 Terminus + 自定义命令：安装
Terminus插件后，建一个 Build System，"target": "terminus_exec"，"cmd"改成启动命令（如["python", "-m", "mypackage"]），这样能交互、能保持终端窗口、支持 stdin
关键配置细节与易错点
无论选哪种方案，以下四点必须核对：
-
$project_path变量只在已保存.sublime-project文件且通过Project → Open Project打开时才有效；直接File → Open Folder不会设置它 - Windows 下路径含空格时，
shell_cmd中每个参数都得单独加双引号，比如"C:\Program Files\Python311\python.exe"，漏一个就command not found - 如果项目依赖相对导入（如
from .utils import helper），必须确保工作目录是包根，所以working_dir得设为"$project_path"，不能留空或用$file_path - 错误跳转（
file_regex）在多文件输出中会混乱——双击可能跳到错误文件的第 1 行而非真实出错行，因为正则只匹配第一组File "...", line N
最常被忽略的是：Sublime 的构建系统本质是“单文件快照执行器”，不是项目管理器。想可靠运行多文件结构，就得把协调逻辑外移到脚本或插件里，而不是反复调整 .sublime-build 的 JSON 字段。
