Sublime Text 项目配置需通过 .sublime-project 文件显式加载,仅放于项目根目录、正确命名(如backend.sublime-project)、用“Project → Save Project As…”生成才生效;窗口标题显示项目名是唯一可靠加载标志,否则仍使用全局设置。

Sublime Text 项目配置不是“打开文件夹就自动生效”的东西,它必须通过 .sublime-project 文件显式加载,且该文件只有在特定路径、命名、保存方式下才被识别。直接拖拽文件夹或用 File → Open Folder…,.sublime-project 完全不生效。
怎么确认当前窗口用了项目配置?
唯一可靠信号是窗口标题栏显示项目名,例如 my-api — Sublime Text。没这个,说明你还在用全局设置(Preferences.sublime-settings),哪怕目录里放了 .sublime-project 也没用。
- 菜单栏
Project → Edit Project能正常打开编辑器 → 说明已加载项目配置 - 点
Project → Save Project As…后文件自动出现在项目根目录(和.git同级),且文件名是xxx.sublime-project(不能有空格、中文、点号多于一个) - 必须同时存在同名的
.sublime-workspace文件(Sublime 自动创建,删掉会导致窗口状态丢失,但项目配置仍可用)
.sublime-project 文件必须放哪、怎么命名?
路径和命名是硬性门槛,错一个就失效:
- 必须放在项目最外层目录(即你希望作为工作区根的那层),不能嵌套在子文件夹里
- 文件名只能是
xxx.sublime-project,比如backend.sublime-project✅,backend project.sublime-project❌(含空格)、backend-项目.sublime-project❌(含中文)、backend.sublime-project.json❌(多了一个.json) - 不能手动新建文本再改后缀——必须用
Project → Save Project As…生成,否则 Sublime 不认
项目配置里的 settings 字段怎么写才覆盖全局?
项目专属设置必须写在 JSON 根级的 "settings" 对象里,不是插件配置块内部:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
{
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true,
"trim_trailing_whitespace": true
},
"folders": [
{
"path": "."
}
]
}
- 上面的
tab_size会真正影响当前项目所有文件的缩进行为 - 如果写成
"SublimeLinter": { "settings": { "python_executable": "/usr/local/bin/python3" } },这只对 SublimeLinter 插件生效,且前提是该插件明确支持项目级参数;它不会改变编辑器本身的缩进、换行等基础行为 -
"folders"中的"path": "."是相对路径写法,推荐用"."或"./src",避免绝对路径导致迁移失败
为什么改了 .sublime-project 没反应?
常见原因不是语法错,而是上下文根本没加载:
- 你只是打开了文件夹,没通过
Project → Open Project…选中那个.sublime-project文件 - 文件保存位置不对(比如放到了
Packages/User/下,那是给构建系统和用户设置用的) - 修改后没重启窗口或重新用
Project → Open Project…加载——Sublime 不监听项目文件变更,改完必须重开 - 误把项目配置当构建系统用:编译命令要写在
Packages/User/xxx.sublime-build里,不是.sublime-project
项目配置的“隔离”本质是上下文切换,不是文件存在即生效。最容易忽略的是:窗口标题没变,就等于一切都没开始。










