Sublime Text的.sublime-build文件必须严格置于Packages/User/目录下才生效,其他任何路径均不被扫描;需合法JSON格式、正确后缀、匹配selector,且首次使用须手动选择构建系统。

Sublime Text 的 .sublime-build 文件必须放在 Packages/User/ 目录下
放错位置就完全不生效——不是“可能无效”,是 Sublime Text 根本不扫描其他路径。它只加载 Packages/User/ 下的 .sublime-build 文件,Packages/Default/、Packages/C++/、桌面、项目根目录,全都不认。
实操建议:
- 用菜单 Preferences → Browse Packages… 直接打开
Packages/文件夹,再进User/子目录 - 在
User/里新建文件,**手动输入后缀**为.sublime-build(例如C++.sublime-build),不要靠重命名,有些系统会隐藏后缀导致实际是C++.sublime-build.txt - 文件必须已保存,且内容是合法 JSON(无语法错误、末尾不能多逗号)
创建新构建系统最稳的方式:用菜单触发模板
别手动建空文件再改路径,容易漏掉关键字段。直接走内置流程更可靠:
- 菜单栏选 Tools → Build System → New Build System…
- 会自动打开一个带基础 JSON 结构的临时文件(含
cmd、selector占位) - 把内容全替换成你的配置,比如 C++ 的
shell_cmd字段 - 按 Ctrl+S 保存,此时 Sublime 会弹出保存对话框——**务必确认路径是
Packages/User/,且文件名以.sublime-build结尾**
保存后还要手动选一次构建系统
即使 selector 写对了(如 "selector": "source.cpp"),新建或打开一个 .cpp 文件后,Sublime 也不一定自动激活它。常见现象是按 Ctrl+B 没反应,状态栏显示 “No build system”。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
原因和解决:
- 首次使用需手动指定:菜单 Tools → Build System,从列表里点你刚保存的名称(如
C++) - 确认当前文件语法高亮是否正确:按
Ctrl+Shift+P输入 Set Syntax: C++,确保作用域是source.cpp,否则selector匹配失败 - 如果列表里没出现你的构建项,99% 是文件没放在
Packages/User/,或保存时后缀不对,或 JSON 有错(可复制内容到 JSONLint 验证)
Windows 下中文路径或空格导致编译失败?变量要加引号
路径含中文、空格或括号(如 C:\Users\张三\code\test.cpp)时,gcc 或 g++ 会直接报错:No such file or directory,哪怕终端里手动敲命令能跑。
根本原因是 shell 解析时未将路径当整体处理。解决方式统一且简单:
- 所有路径变量必须用双引号包裹:
"${file}"、"${file_path}/${file_base_name}.exe" - Windows 推荐用
shell_cmd而非cmd数组,避免&&不被识别、空格路径崩掉等问题 - 示例有效写法:
"shell_cmd": "g++ -std=c++17 \"${file}\" -o \"${file_path}/${file_base_name}.exe\""
Packages/User/ 这个路径没进对、JSON 少了个引号、或者选构建系统那一步跳过去了。这些细节不显眼,但缺一不可。

















