Sublime Text切换构建系统需确保文件合法、存放于Packages/User/目录、含正确cmd和path字段,并用sys.executable验证;否则菜单选择无效。

Sublime Text 里切换构建系统,不是点一下菜单就完事——得先确保构建系统文件本身是合法、放对位置、且能被识别;否则选了也白选,Ctrl+B 还是跑默认解释器。
构建系统文件必须放在 Packages/User/ 目录下才生效
Sublime 只扫描固定路径:Packages/User/。其他地方全忽略:项目根目录、桌面、Packages/Python/ 子目录、甚至你手动新建的同名文件夹都不行。
- 最稳操作:菜单栏 Preferences → Browse Packages…,直接打开弹出的
User文件夹再保存 - Windows 路径示例:
%APPDATA%\Sublime Text\Packages\User\ - macOS 路径示例:
~/Library/Application Support/Sublime Text/Packages/User/ - 文件名不能含空格或中文,后缀必须是
.sublime-build(不是.json,也不是.sublime-build.txt)
cmd 和 path 字段缺一不可,尤其用虚拟环境时
只改 cmd 指向虚拟环境里的 python.exe 或 python,但漏掉 path 字段,运行时大概率报 ModuleNotFoundError——因为 Sublime 不会自动把虚拟环境的 Scripts(Windows)或 bin(macOS/Linux)加进 PATH。
-
path字段值是目录(如C:\myproject\venv\Scripts),不是可执行文件 -
cmd中的路径推荐用绝对路径,避免歧义;Windows 下路径含空格必须加英文双引号 - macOS/Linux 示例中,
cmd里写的是/Users/you/myproject/venv/bin/python,不是python简写
验证是否真切过去了,别信菜单名
菜单里显示 “Python3.11_Custom” 不代表它真在跑。在 Python 文件里写一行:import sys; print(sys.executable),然后 Ctrl+B 运行。输出路径必须和你 .sublime-build 里写的 cmd 路径完全一致,才算成功。
- 常见假成功:菜单选了,但输出还是
/usr/bin/python3——说明文件没生效,或 JSON 有语法错误(比如末尾多逗号、用了单引号、写了注释) - 查不准当前文件的
selector?打开文件后按Ctrl+Shift+P输入Syntax: Show Syntax,就能看到实际值 - 想让一个构建系统对多个语言生效,可以用逗号分隔:
"selector": "source.python, source.js"
最容易被忽略的是 path 字段和文件存放位置——这两处错一个,整个构建系统就形同虚设。验证时别跳过 sys.executable,这是唯一可信的依据。

















