xxx.sublime-workspace 是 Sublime Text 自动生成的二进制 JSON 快照，记录窗口状态，不可手动编辑；应配置同名 .sublime-project 文件，需放项目根目录、JSON 格式正确、含 "folders" 等指定字段，修改后须关闭并重新打开项目生效。
工作区文件 xxx.sublime-workspace 是什么，为什么不能直接编辑？
它不是纯文本配置文件，而是 Sublime Text 运行时自动生成的二进制 JSON 快照，记录了当前所有打开的文件、折叠状态、光标位置、已启用的插件面板等。手动修改会破坏校验或被下次启动覆盖——所以别用文本编辑器硬改 xxx.sublime-workspace，真正要配的是对应的 xxx.sublime-project。
.sublime-project 文件里怎么写才能生效？
必须放在项目根目录，且文件名与文件夹名一致（如 myapp/ 下建 myapp.sublime-project）。内容是标准 JSON，但只认特定字段：
-
"folders"：必填，数组，每个对象含"path"（绝对路径或相对于 project 文件的相对路径） -
"settings"：可选，覆盖全局设置，比如"tab_size": 2、"trim_trailing_white_space_on_save": true -
"build_systems"：可选，定义自定义构建命令，注意"file_regex"和"shell_cmd"要匹配你的环境
示例最小可用结构：
{
"folders":
[
{
"path": "."
}
],
"settings":
{
"font_size": 13,
"ignored_packages": ["Vintage"]
}
}
多文件夹项目怎么避免路径混乱？
Sublime 不支持“嵌套工作区”，但允许一个 project 文件声明多个 "folders"。关键点：
- 所有
"path"值必须指向真实存在的目录，不存在会静默忽略 - 相对路径以
.sublime-project所在位置为基准，不是以当前打开位置为准 - 如果两个文件夹有同名子目录（如都含
src/），资源跳转（Ctrl+P）可能混淆，建议用"name"字段区分：{"path": "backend", "name": "backend"} - Windows 下路径分隔符用
/或\都可以，但不要混用
为什么改了 .sublime-project 没反应？
常见失效原因：
- 没关闭再重开项目：Sublime 不监听 project 文件变更，改完必须通过
Project → Close Project再用Project → Open Project…重新加载 - 误把 project 文件当 workspace 打开：双击
.sublime-project是加载项目；双击.sublime-workspace只是恢复上次窗口状态，不读 project 配置 - 语法错误：JSON 缺少逗号、引号不闭合、用了注释（JSON 不支持
//或/* */）都会导致整个 project 配置被跳过，控制台（Ctrl+`）会报error parsing project - 路径含中文或空格未加引号：虽然 Sublime 通常能处理，但在某些插件（如 SideBarEnhancements）中可能导致右键菜单异常
最稳妥的验证方式：打开项目后，按 Ctrl+Shift+P 输入 Project Settings – User，看是否显示你写的 settings 内容。
