默认python构建系统import失败，是因为它只调用path中的python，不感知虚拟环境；必须显式配置path字段指向venv的scripts或bin目录，并在cmd中使用绝对路径指定解释器，否则无法加载已安装的包。
为什么默认 Python 构建系统会 import 失败
Sublime Text 自带的 Python.sublime-build 只调用系统 PATH 里的 python，完全不感知你项目中激活的虚拟环境。哪怕你在终端里 source venv/bin/activate 了，Sublime 也看不到——它不读 shell 的环境变量，更不会继承终端的 PATH。所以一运行就报 ModuleNotFoundError，不是代码写错了，是根本没连上你装了 requests 或 numpy 的那个环境。
-
path字段必须显式指向虚拟环境的Scripts（Windows）或bin（macOS/Linux）目录，否则import时找不到已安装的包 -
cmd中的 python 路径推荐用绝对路径，避免因工作目录变化导致执行失败 - 只改
cmd不设path，等于只换了解释器但没换包搜索路径，90% 的“能跑但 import 报错”都出在这儿
如何为单个项目绑定专属构建系统
全局构建系统（放在 Packages/User/ 下）对所有文件生效，但一个团队里可能同时开着 Django 项目、FastAPI 服务、数据清洗脚本，各自依赖不同版本的 Python 和包。这时得用项目级配置，靠 .sublime-project 文件驱动。
- 先通过
Project → Save Project As…生成.sublime-project文件，否则项目设置不生效 - 在该文件里添加
build_systems数组，每个对象定义一个构建任务，例如"name": "Python (venv-django)" -
cmd和path都支持变量如$project_path，路径可写成"$project_path/venv/bin/python"，比硬编码更安全 - 项目打开后，
Tools → Build System里会出现你定义的名称，选中即生效，无需手动切换
Windows 下路径含空格导致构建失败怎么办
Windows 用户常把项目建在 C:UsersYour Namemyproject 这类带空格的路径下，此时 cmd 数组里如果直接写 "C:UsersYour Name envScriptspython.exe"，Sublime 会把它拆成两个参数："C:UsersYour" 和 "Name envScriptspython.exe"，直接报错“系统找不到指定的文件”。
- 必须给整个路径加英文双引号，且用反斜杠转义：
""C:\Users\Your Name\venv\Scripts\python.exe"" -
path字段同理，也要加引号：""C:\Users\Your Name\venv\Scripts"" - 更稳妥的做法是把项目移到无空格路径，比如
C:devmyproject，一劳永逸避开这类 shell 解析问题
构建系统不显示在菜单里的排查顺序
写了 JSON、保存了文件、重启了 Sublime，但 Tools → Build System 里还是看不到新选项——这不是玄学，是几个刚性条件没满足。
- 文件必须保存在
Packages/User/目录下（可通过Preferences → Browse Packages → User确认路径） - 文件名必须以
.sublime-build结尾，且不能含空格、中文、括号，例如py311_venv.sublime-build合法，py3.11 (venv).sublime-build不合法 - JSON 不能有末尾逗号（trailing comma），Sublime 对语法错误零容忍，可用 jsonlint.com 快速验证
- 如果用了 BOM（常见于 Windows 记事本另存为 UTF-8 带签名），Sublime 会静默忽略该文件，务必用 Sublime 自身另存为 UTF-8（无 BOM）
path 字段和项目路径变量的组合使用——很多人只记得配 cmd，却忘了告诉 Sublime 去哪儿找 pip 和第三方模块；而项目级配置里若不用 $project_path，换台电脑或共享代码时就得重写一堆绝对路径。这两点不处理好，构建系统就只是个能跑 hello world 的摆设。
