Sublime Text 无内置单文件/工程模式开关，本质是构建系统作用域与项目上下文的组合；问题根源在于 working_dir 默认值不同，单文件为 $file_path，项目中若未配置则仍用 $file_path 或启动目录，导致模块导入失败。
Sublime Text 本身没有“单文件运行”和“工程模式”的内置开关，所谓切换，本质是构建系统（build system）作用域 + 项目上下文（.sublime-project）的组合结果。不保存项目、乱配 working_dir 或误用 Add Folder to Project…，就会出现“同一份 Python 脚本，在单文件下能跑，加进项目就报 ModuleNotFoundError”这类问题。
为什么 Ctrl+B 运行单文件时正常，加入项目后就找不到模块
根本原因是构建系统默认工作目录不同：
- 单文件运行时，
working_dir默认为该文件所在目录（即$file_path），import utils就去同级找 - 加入项目后，若没显式配置
"working_dir": "$project_path"，构建系统仍以$file_path为起点，但项目结构里utils.py可能在src/下，路径对不上 - 更隐蔽的问题：有些构建系统模板（比如 Python3.sublime-build）压根没写
working_dir字段，它就按 Sublime 启动时的当前目录走——可能是个空桌面，也可能是个旧项目根目录
如何让一个构建系统同时适配单文件和项目场景
靠变量动态判断，而不是写死路径。Sublime 支持的变量中，$project_path 在无项目时为空字符串，可利用这点 fallback：
{
"shell_cmd": "python3 -u \"$file\"",
"working_dir": "${project_path:$file_path}",
"file_regex": "^.*?File \"(.*?)\", line ([0-9]*)",
"selector": "source.python"
}
-
${project_path:$file_path}表示：如果$project_path存在且非空，就用它；否则退回到$file_path - 这样一份配置，既能在双击打开的单
.py文件上运行，也能在加载了.sublime-project的窗口中正确识别项目根目录 - Windows 用户注意：
shell_cmd中的引号要统一用双引号，且$file必须包裹在引号内，否则含空格路径会崩
项目内运行单文件时，怎么临时跳过项目设置
有时你只想快速测试某个脚本，不想受项目级 settings 干扰（比如禁用了 translate_tabs_to_spaces 导致缩进错乱）。这时不能靠关掉项目，而是直接覆盖构建行为：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）→ 输入Set Build System→ 选Python（系统自带）而非你自定义的Python3 (Project) - 或者右键编辑器空白处 →
Build With…→ 选一个不读取项目配置的构建系统 - 关键区别在于：系统自带构建系统（如
Python.sublime-build）通常不含working_dir，也不引用$project_path，天然“单文件友好” - 别指望
Tools → Build System → Automatic能智能切换——它只看selector匹配语法类型，不感知项目上下文
侧边栏显示多个文件夹 ≠ 工程模式已启用
很多人拖拽多个文件夹进同一个窗口，以为这就是“工程模式”，结果 Ctrl+P 搜不到其他目录下的文件，Go to Anything 也只索引第一个文件夹。这是因为：
- Sublime 的“项目”必须由
.sublime-project文件激活，仅靠Add Folder to Project…添加的路径，不会自动触发全量索引 - 这些文件夹只是被挂载到侧边栏，但
Goto Anything默认只搜索“当前活动视图所在文件夹及其子目录”，除非你在.sublime-project的"folders"字段里显式列出它们 - 验证是否真进了工程模式：菜单栏应显示项目名（如
my-api.sublime-project），且Project → Edit Project可打开 JSON 编辑界面
最易被忽略的一点：构建系统里的 shell_cmd 和 working_dir 是解耦的。哪怕你写了 "working_dir": "$project_path"，如果 shell_cmd 里硬编码了 /home/user/project/src/main.py，那它永远只跑那个路径——变量只在 JSON 解析阶段生效，不会重写命令字符串里的字面量。
