Sublime项目配置必须用.sublime-project文件，因为只有通过Project → Save Project As…手动保存生成的该文件才被识别为有效项目，否则所有设置均为临时状态；folders字段必填且格式严格，修改settings后须手动Reload Project才生效。
Sublime项目配置为什么必须用.sublime-project文件
因为 Sublime Text 不会自动把“打开的文件夹”变成项目——只有手动执行 Project → Save Project As…，才会生成真正生效的 .sublime-project 文件。没这一步，所有所谓“项目设置”都是临时状态，关窗就丢。
常见错误现象包括：侧边栏空、settings 不生效、插件（如 SublimeCodeIntel）扫描不到目录、构建系统找不到路径。这些都不是插件问题，而是根本没项目。
- 菜单项
Project → Save Project As…灰色不可点？说明你还没通过File → Open Folder…或Project → Add Folder to Project…加载过任何合法路径 - 保存后窗口标题没显示项目名（如
myapp — Sublime Text）？大概率是文件名含空格或中文（my app.sublime-project会静默失效） - 双击
.sublime-project只开空窗口？不是文件损坏，是它依赖前置的“已加载上下文”——必须先用Open Folder…打开过对应路径，再保存，才能正向加载
folders 字段写错会导致整个项目“隐身”
"folders" 是 .sublime-project 的必填字段，且容错极低：Sublime 静默忽略非法结构，不报错、不提示，只让侧边栏变空。这是团队协作中最常踩的坑。
正确写法示例：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
{
"folders": [
{
"path": ".",
"folder_exclude_patterns": ["node_modules", "dist", "build"],
"file_exclude_patterns": ["*.log"]
}
]
}
- 路径必须存在：
"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）
团队共享配置不能靠同步 User 目录
同步 Packages/User/ 目录只能共享全局偏好和插件列表，但不同项目需要不同的 Python 解释器路径、linter 参数、索引范围——强行统一会导致 SublimeLinter 找不到 flake8、SublimeCodeIntel 索引错目录、格式化命令在 A 项目生效，在 B 项目报 command not found。
真正要共享的，是每个项目独有的行为逻辑，必须绑定在 .sublime-project 中，并配合外部工具协同：
-
.editorconfig必须用 LF 换行（Windows 记事本保存会变 CRLF，导致插件跳过） - 语言级格式规则（如
.prettierrc.yml、.pycodestyle）不要塞进 Sublime 的Preferences.sublime-settings，而应放在项目根目录 - 所有格式化命令（如通过
Exec插件调用）必须设"save_before": true，否则读的是未保存的缓冲区脏数据 - 禁用插件自带的 “on_save format” 开关，统一走 Sublime 原生
on_save+exec调外部命令，避免触发时机混乱
复杂点在于：.sublime-workspace 文件记录个人状态（打开的标签页、光标位置），必须加到 .gitignore；而 .sublime-project 文件才该纳入版本控制——很多人混淆这两者，一并提交，结果每次 pull 都覆盖掉别人的工作现场。
