Sublime Text项目配置仅在通过Project → Open Project…加载.sublime-project文件时生效,直接拖拽文件夹或File → Open Folder…不会触发项目上下文;窗口标题显示项目名是配置生效的唯一可靠信号,且.sublime-project必须与同名.sublime-workspace成对存在、保存于根目录、文件名不含空格或中文,settings须置于JSON根级。

项目配置只在 .sublime-project 加载时生效,不是打开文件夹就自动启用
直接拖拽文件夹进 Sublime 或用 File → Open Folder… 打开目录,不会加载任何项目级配置。此时所有设置都走全局 Preferences.sublime-settings,.sublime-project 文件形同虚设。
真正触发项目上下文的唯一方式是:Project → Open Project… 并选中那个 .sublime-project 文件。窗口标题栏出现项目名(如 my-api — Sublime Text),才是配置已生效的可靠信号。
-
.sublime-workspace必须和.sublime-project同目录、同名(仅扩展名不同),缺一不可;删掉 workspace 文件,窗口状态会丢,但项目配置仍可用 - 手动新建
.sublime-project文件或用文本编辑器保存,Sublime 一概不认——必须通过Project → Save Project As…生成 - 文件名不能含空格、中文、特殊符号(
my-app.sublime-project✅,my app.sublime-project❌)
settings 字段必须写在 JSON 根级,嵌套或放错位置等于没写
常见错误是把项目专属设置写进插件配置块里,比如:
{
"SublimeLinter": {
"settings": { "python_executable": "/usr/local/bin/python3" }
}
}
这样写,python_executable 不会覆盖全局 Python 路径——它只对 SublimeLinter 插件生效,且前提是该插件明确支持项目级参数。而真正影响编辑行为的缩进、换行、自动补全等,必须放在根级 "settings" 下:
{
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true,
"trim_trailing_whitespace": true
},
"folders": [
{ "path": "." }
]
}
- 根级
settings优先级高于 User 设置,但低于语法特定设置(如Python.sublime-settings) - 插件是否响应项目级配置,取决于插件本身实现;例如
SublimeCodeIntel支持"scan_files_in_project": true,但很多插件根本不读这个字段 - 改完
.sublime-project后,需关闭再重新Open Project,热重载不生效
多项目共存靠窗口隔离,Add Folder to Project 不等于多项目
Add Folder to Project 只是把多个路径拼进同一个项目视图,所有文件共享同一套 settings 和插件行为。前端项目配了 ESLint,后端 Python 文件也会被误检——这不是隔离,是污染。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
真要同时处理前后端,必须开新窗口:subl --new-window /path/to/frontend 和 subl --new-window /path/to/backend。Windows 上注意路径带引号,macOS 若用 Snap 安装,--new-window 可能失效,建议换 tarball 版本。
-
Project → Switch Project不是切换标签页,而是关闭当前项目、加载另一个.sublime-project,本质是跳转,不是并存 - 菜单里的
New Window或快捷键Ctrl+Shift+N不可靠,某些版本复用前台窗口,根本没新开进程 - 每个窗口独立加载自己的
.sublime-workspace,关窗前未保存的修改、光标位置、分割面板都会保留
团队共享配置的关键是沉入项目,而非同步 User 目录
把 Preferences.sublime-settings 或插件配置同步到团队成员机器上,只会让所有人用同一套规则——而实际项目需要的是:A 项目用 2 空格缩进 + Prettier,B 项目用 4 空格 + Black。强行统一会导致构建失败、格式化报错、索引路径错乱。
正确做法是把 .sublime-project 提交到 Git,并确保它只包含三类内容:
-
folders:明确列出参与索引的路径,用folder_exclude_patterns排除node_modules、venv等无关目录 -
settings:覆盖编辑器基础行为,如tab_size、detect_indentation - 插件专属块(如
"SublimeLinter"):仅当插件文档明确说明支持项目级参数时才写
.sublime-workspace 文件记录个人状态(打开的文件、光标位置),应加入 .gitignore,绝不提交。
项目配置生效的前提,是团队成员都用 Project → Open Project… 打开 .sublime-project,而不是双击文件夹或用命令行 subl .——后者绕过项目加载机制,配置静默失效。

















