Sublime构建系统不自动识别项目结构，需手动配置working_dir为$project_path并设置env.PYTHONPATH="$project_path"，否则import跨目录模块会失败；未保存.sublime-project时$project_path为空，构建将无法定位项目根目录。
Sublime构建系统根本不会“识别”项目文件夹
构建系统（sublime-build）本身不读取 .sublime-project 中的 folders 或路径设置，它只关心当前激活的视图（即你正在编辑的文件）和系统环境。所谓“在项目里运行 Python”，其实是靠你手动保存了 .py 文件、设对了语法、选对了构建系统，再配合 $file 这类变量间接实现的。
常见错误现象：项目已添加 src/ 和 tests/ 两个文件夹，但按 Ctrl+B 运行 src/main.py 时却报错 No module named xxx——这不是构建系统没“识别项目”，而是 Python 解释器根本不知道该去哪找模块。
- 构建系统不自动添加
PYTHONPATH，也不会帮你切工作目录到项目根目录 -
$file展开的是当前文件的绝对路径，不是项目根目录；想用项目路径得靠$project_path，但它只在项目已加载且有.sublime-project时才有效 - 如果文件未保存（仍是
Untitled），$file为空字符串，构建直接失败
让 Python 构建真正“感知项目结构”的关键配置
要让 import mypackage 在 src/main.py 里正常工作，必须显式控制 Python 的执行上下文。最可靠的方式是自定义一个带 working_dir 和环境变量的构建系统。
实操建议（以项目根目录为工作目录）：
- 确保项目已保存为
.sublime-project文件（否则$project_path为空） - 在
Packages/User/下新建Python3-Project.sublime-build，内容如下：
{
"cmd": ["python3", "-u", "$file"],
"file_regex": "^.*?File "(...*?)", line ([0-9]*)",
"working_dir": "$project_path",
"selector": "source.python",
"env": {"PYTHONPATH": "$project_path"}
}
注意：working_dir 决定 os.getcwd() 返回什么，env.PYTHONPATH 才让 import 能跨目录解析。Windows 用户请把 python3 换成完整路径并加双引号，例如 "C:\Users\Me\AppData\Local\Programs\Python\Python311\python.exe"。
为什么改了 folder_exclude_patterns 对构建没任何影响
folder_exclude_patterns 只影响 Sublime 的索引行为（比如 Ctrl+P 能否跳转、侧边栏是否显示子项），它不参与构建流程，也不改变 cmd 执行时的文件系统视角。
你可能会遇到这些混淆点：
- 在项目设置里加了
"folder_exclude_patterns": ["node_modules"]，但构建时仍因import到node_modules/.bin下某个工具而失败——这是 Python 自己的行为，Sublime 不拦截也不干预 - 误以为排除了
dist/就能防止构建命令写入那里，其实cmd里写的["python", "build.py", "--output", "dist/"]照常执行，跟排除配置无关 -
folder_exclude_patterns写在用户设置里，会导致所有项目都跳过那些目录索引，但构建系统照样能cd进去或import里面的东西
调试构建系统是否真用了项目路径
最直接的办法是临时让构建输出当前工作目录和 $project_path 值：
- 新建一个
debug.py，内容为：
import os
print("PWD:", os.getcwd())
print("PROJECT_PATH:", os.environ.get("PROJECT_PATH", "NOT SET"))
- 在构建系统里把
cmd改成：["python3", "-u", "$file"] - 确保该文件已保存、语法设为 Python、构建系统选中你刚配的
Python3-Project - 运行后看输出：
PWD应该等于你的项目根目录；若显示空或不对，说明$project_path没生效——大概率是没先通过Project → Save Project As…创建.sublime-project
别指望构建系统自动推导项目结构。它没有“项目意识”，只有你给它的变量和路径。漏掉 $project_path 或忘了保存项目文件，后面所有基于路径的操作都会失效。
