sublime text 自带构建系统位于只读内置包中,需用 packageresourceviewer: open resource 命令(ctrl+shift+p)依次选择 python → python.sublime-build 打开只读源文件,复制内容到新文件并保存为 .sublime-build 后缀、置于 packages/user/ 目录下,再手动在 tools → build system 中选中启用。

怎么找到已安装的构建系统文件
Sublime Text 自带的构建系统(比如默认的 Python.sublime-build)不放在用户目录下,而是藏在只读包路径里,直接编辑会失败。你不能通过菜单“New Build System”打开它来改——那个只是新建模板。
正确做法是:用 PackageResourceViewer: Open Resource 命令(Ctrl+Shift+P 输入后回车),依次选择 Python → Python.sublime-build。它会以只读方式打开原始文件,这时别改它,而是复制全部内容到一个新文件里再保存为自定义名。
- Windows 路径示例:
Packages/Python/Python.sublime-build - macOS/Linux 同理,但实际路径不可写,必须另存
- 如果你装了第三方 Python 包(比如 Anaconda),它的构建系统也可能被优先匹配,得先确认当前生效的是哪个
修改后如何让 Sublime 识别新配置
保存时必须用 .sublime-build 后缀,且放到 Packages/User/ 目录下(Tools → Developer → Browse Packages… 可直达)。文件名任意,但 name 字段值必须唯一且准确,否则 build_with 找不到。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 如果原构建系统有
"selector": "source.python",你改了cmd但没动selector,它仍只对.py文件生效 - 多个构建系统
name相同(比如都叫Python),Sublime 会按文件路径顺序取第一个,不保证是你刚存的那个 - 改完别忘了在 Tools → Build System 菜单里手动选中你的新配置,否则 Ctrl+B 还是走旧的
为什么改了配置却还是调用 python2
最常见原因是 cmd 里写的还是 python,而系统 PATH 里 python 指向的是 Python 2。不是 Sublime 的错,是 shell 解析出来的结果。
- Windows 用户建议写绝对路径,比如
"C:/Users/xxx/AppData/Local/Programs/Python/Python311/python.exe" - macOS/Linux 用户可改用
python3,或用which python3查准路径再填 - 加
"shell": true能绕过某些 PATH 解析问题,但会牺牲部分跨平台稳定性 - 验证方式:在 Python 文件里写
import sys; print(sys.executable),运行看输出路径
项目级覆盖时 name 字段怎么写才有效
项目配置(.sublime-project)里的 build_systems 数组中,每个对象的 name 字段必须和你自定义的 .sublime-build 文件里顶层 "name" 值**完全一致**,包括空格、括号、大小写。
- 例如文件里是
"name": "Python (venv)",项目配置里就得写"name": "Python (venv)",少个空格都不行 - 项目配置不会自动继承 User 目录下的构建系统,必须显式列出或设为
default_build_system - 如果项目里写了
build_systems但没设default_build_system,Ctrl+B 仍可能 fallback 到全局第一个可用构建系统
name,得重启 Sublime 或者手动切换一次构建系统,否则缓存可能还在用旧版本。










