sublime的项目工作区必须通过project → save project as…手动保存生成.sublime-project文件,否则无真正项目;该操作需先加载文件夹,路径须合法且folders字段必填,修改settings后须reload project才生效。

Sublime 的项目工作区不是“建出来”的,而是“存出来”的——没手动执行 Project → Save Project As…,就根本没有真正项目。
为什么 Save Project As… 是唯一入口
Sublime 不会因为你打开了一个文件夹、或点了 Add Folder to Project 就自动生成项目。它只在你显式触发 Project → Save Project As… 时,才把当前窗口状态“快照”成一个 .sublime-project 文件。
- 菜单项灰色不可点?说明你还没通过
File → Open Folder…或Project → Add Folder to Project…加载过任何目录 - 保存后窗口标题栏没显示项目名(如
myapp — Sublime Text)?大概率文件没存到项目根目录,或文件名含空格/中文(my app.sublime-project会静默失效) - 双击
.sublime-project文件只开空窗口?不是文件损坏,是它依赖前置的“已加载上下文”——必须先用Open Folder…打开过路径,再保存,才能正向加载
folders 字段写错,整个项目就“隐身”
"folders" 是必填字段,且容错极低:Sublime 静默忽略非法结构,不报错、不提示,只让侧边栏变空。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 路径必须存在:
"path": "src/utils"如果该目录不存在,Sublime 直接跳过,不挂载 - 相对路径以
.sublime-project文件所在位置为基准,不是以当前工作目录为准;推荐统一用"path": "." - Windows 下也必须用正斜杠
/,混用\和/会导致解析失败 - 排除模式大小写敏感:
"folder_exclude_patterns": ["Node_modules"]不会屏蔽node_modules
settings 修改后不生效?重载才是关键动作
.sublime-project 里的 "settings" 不会热更新。改完 JSON 后,必须手动重载项目,否则缩进、换行、构建系统全都不走新配置。
- 正确操作:改完保存 →
Project → Reload Project(快捷键Ctrl+Alt+P/Cmd+Alt+P),再搜 “Reload” 执行 - 常见误操作:以为保存 JSON 就 OK;或误点
Project → Close Project后直接关窗,导致 workspace 状态丢失 -
"color_scheme"和"theme"在 project 文件里被完全忽略,控制台会输出Ignoring invalid project setting: color_scheme,这不是 bug - 想验证 settings 是否被读取?在 Python 控制台运行:
sublime.active_window().active_view().settings().get("my_test")(前提是 project 里写了"my_test": true)
别碰 .sublime-workspace,它不是配置文件
xxx.sublime-workspace 是 Sublime 自动生成的二进制快照,记录光标位置、打开标签页、分组状态等。它不可编辑、不应提交、也不该被当配置文件去调。
- 双击
.sublime-workspace只恢复上次窗口状态,不加载.sublime-project配置 - 修改
.sublime-project后,不关闭重开项目,.sublime-workspace也不会自动同步——它只在窗口关闭时写入 - Git 中应加
*.sublime-workspace到.gitignore;而.sublime-project建议提交,尤其含build_systems或团队共用settings时
最常被忽略的一点:Sublime 的项目是“窗口级”的,不是“标签页级”的。想同时对比两个项目?只能开两个窗口,各自加载一个 .sublime-project。试图在一个窗口里“切换项目”,本质只是在同一个 project 配置下增删文件夹,所有设置、构建系统、折叠状态仍共享。










