sublime text 项目配置需手动创建和重载 .sublime-project 文件，改 settings 后必须执行 project → reload project 或快捷键重载，仅保存无效；folders 为必填项且格式严格，路径须用正斜杠、utf-8 编码、避免中文空格；多文件夹项目应通过 add folder to project 添加并 save project 持久化；.sublime-workspace 记录个人会话，应忽略 git；插件是否读取项目设置取决于其是否调用 view.settings()。
Sublime Text 没有传统 IDE 那种自动维护状态的“项目工程”，它靠的是手动创建、手动加载、手动重载的 .sublime-project 文件——写错、漏字段、路径不对、不重载，设置全都不生效。
为什么改了 settings 却没反应？
因为 Sublime 不监听 JSON 变更，也不热更新配置。你改完 .sublime-project 里的 "tab_size": 2 或 "spell_check": false，必须主动触发重载：
- 菜单栏点击
Project → Reload Project - 或用快捷键
Ctrl+Alt+P（Win/Linux）/Cmd+Alt+P（Mac），输入 “Reload” 执行 - 仅保存文件不会生效；重启 Sublime 也行，但没必要
- 如果重载后仍无效，检查
settings是否在顶层，不是嵌套在folders里或其他对象中
folders 字段写错会导致整个项目加载失败
folders 是必填项，且格式极其严格。常见失效情形包括：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 值为空数组：
"folders": []→ Sublime 静默忽略该文件，侧边栏空白 - 路径用了反斜杠：
"path": "C:\myproject"→ 必须用正斜杠："path": "C:/myproject" - 路径拼写错误或不存在（如
"path": "srce"）→ Sublime 跳过该条目，不报错也不提示 - 文件名含中文或空格（如
我的项目.sublime-project）→ 配置静默失效 - 未通过
Project → Save Project As…创建，而是手动生成空 JSON → 容易缺字段、编码错误（必须 UTF-8）、逗号遗漏
如何让多个不相关文件夹共存于一个项目？
比如同时管理 frontend/ 和 backend/，不能只靠打开根目录。正确做法是：
- 先用
File → Open Folder…打开其中一个（如frontend/） - 再用
Project → Add Folder to Project添加backend/ - 添加后必须执行
Project → Save Project（注意不是Save Project As…），否则重启即丢失 - 每个
folder对象可独立设name、folder_exclude_patterns、file_exclude_patterns - 路径推荐用变量：
"path": "${folder}"或相对路径"path": "."，避免硬编码绝对路径
.sublime-workspace 文件不该提交，但很多人误以为它是项目配置
.sublime-workspace 记录的是个人会话状态：哪些标签页开着、光标在哪、分屏怎么排、终端是否打开。它和 .sublime-project 是配套生成的，但作用完全不同：
-
.sublime-project可提交到 Git，用于团队统一项目结构和设置 -
.sublime-workspace应加进.gitignore，否则会把你的临时编辑状态推给所有人 - 右键侧边栏选
Remove Folder from Project只影响当前会话，不改.sublime-project；要持久化移除，得编辑 JSON 并重载 - 插件是否读取项目设置，取决于它是否调用
view.settings()；color_scheme和theme在项目文件中会被 Sublime 直接忽略
