直接删除Packages/User/目录下的Python_Custom.sublime-build等文件即可,但需重启Sublime或执行Refresh Projects刷新菜单缓存,否则仍显示残留项并报错。

Sublime 怎么删掉自定义的 Build System 文件
直接删 Python_Custom.sublime-build 这类文件就行,但得知道它在哪、删错位置没用,而且删完不会自动从菜单里消失——菜单项是缓存的,得重启或手动刷新。
Build System 文件本质就是 JSON 格式的配置文件,保存在 Packages/User/ 目录下。只要关掉 Sublime Text,进这个目录,找到对应文件(比如 Python_Venv.sublime-build 或 MyNodeJS.sublime-build),删掉即可。
-
Packages/User/路径定位方式:Preferences → Browse Packages… → 打开的就是User文件夹 - 别去
Packages/根目录或Installed Packages/里找,那里面没有你手动建的构建系统 - 文件名必须以
.sublime-build结尾,否则 Sublime 不识别;删的时候别只改后缀或重命名,要真删
删了文件,为什么 Tools → Build System 菜单里还显示?
因为 Sublime 启动时会扫描 Packages/User/ 并缓存可用的构建系统列表,不重启就不会更新。即使文件已删,菜单里仍残留条目,点进去会报错:Unable to find build system。
解决方法只有两个:
- 重启 Sublime Text —— 最简单可靠
- 或者执行命令:
Ctrl+Shift+P→ 输入Refresh Projects(不是刷新项目,是刷新构建系统缓存)→ 回车。但该命令不一定存在,取决于你装的插件;没这命令就老老实实重启
想批量删多个自定义构建系统,又不想一个个找?
可以按名称规律批量操作,比如你习惯用 Python_* 或 Node_* 命名,那就直接在 Packages/User/ 里搜 .sublime-build,再筛一遍关键词。
注意别误删系统自带的构建系统文件 —— 它们不在 User 目录里,在 Packages/ 的子目录中(如 Packages/Python/ 下的 Python.sublime-build),这些不能动,删了会导致“Python”菜单项消失且无法恢复,除非重装插件。
- Windows:用资源管理器进
%APPDATA%\Sublime Text\Packages\User\,搜索*.sublime-build - macOS:终端执行
ls ~/Library/Application\ Support/Sublime\ Text/Packages/User/*.sublime-build - Linux:
ls ~/.config/sublime-text/Packages/User/*.sublime-build
删构建系统前,要不要备份?
如果你改过很多参数(比如指定了虚拟环境路径、加了 -m pdb、配了自定义 file_regex),建议删之前复制一份到桌面。这类配置很难靠回忆还原,尤其当多个 Python 版本混用时,路径写错一个斜杠就 build failed。
另外注意:项目级构建系统(放在 .sublime-project 文件里的 build_systems 配置)不受影响,那是独立存储的,删 User/ 下的文件不会动它。
最常被忽略的是:删完不重启,然后以为没删成功,又去重复操作 —— 其实文件早没了,只是菜单没刷新而已。
















