Sublime Text项目配置文件加载失败是因folders字段路径无效导致静默跳过，必须确保其为顶层必填数组、每个元素含合法path字符串、路径真实存在且不含中文或空格，修改后需手动重载项目才生效。
Project 文件路径丢失不是配置被删了，而是 Sublime 在加载 .sublime-project 时解析失败或找不到对应目录——它不会报错，只会静默跳过该 folders 条目，导致侧边栏空、搜索失效、插件监听不触发。
检查 .sublime-project 中的 folders 字段是否有效
路径字段一旦指向不存在的目录、含非法字符或格式错误，Sublime 就直接忽略整条记录，不提示、不警告、不 fallback。
- 用 VS Code 或记事本打开项目根目录下的
.sublime-project，确认folders是数组，且每个元素都有path键，例如：[{"path": "src"}, {"path": "../shared"}] - Windows 下路径必须用正斜杠
/或双反斜杠\；单个是 JSON 转义符，会导致解析中断（如"path": "D:myproj"实际等价于"path": "D:myproj"） - 路径不能以
.开头（如"path": "./src"），Sublime 不支持相对路径前缀；必须是绝对路径或相对于项目文件自身的相对路径（即src可，./src不可） - 含中文或空格的路径必须确保整个
.sublime-project文件保存为 UTF-8 编码，且 Sublime 已启用enable_unicode_paths
验证项目目录是否真实存在且可访问
Sublime 不做权限预检，只要 os.path.isdir() 返回 False，就当该路径不存在，直接丢弃。
- 在终端中执行
ls -la（macOS/Linux）或dir（Windows）确认路径输出正常，无 “拒绝访问” 或 “找不到文件” 提示 - 符号链接（symlink）路径需额外验证：运行
readlink -f path（Linux/macOS）或dir /a:l（Windows）看目标是否真实可达 - 如果路径曾存在但已被移动/删除，Sublime 不会自动清理
folders数组，需手动删掉对应项或改写为当前有效路径 - 便携版 Sublime 在不同机器间拷贝项目时，路径常因盘符变化失效（如原为
D:/code/app，新机器只有 C 盘），建议统一用相对路径或重映射
避免 Add Folder to Project… 导致路径叠加混乱
菜单里的 Add Folder to Project… 并非“追加”，而是把新路径合并进当前项目结构；若项目已损坏或 folders 为空，它可能写入无效结构，甚至覆盖原始配置。
- 优先使用命令面板：
Ctrl+Shift+P→ 输入Project: Add Folder to Project→ 回车，比菜单更稳定 - 如果侧边栏突然变空，立刻检查用户设置里是否有
"project": null—— 这行会清空所有已加载路径 - 修改
.sublime-project后，必须手动执行Ctrl+K→Ctrl+B刷新视图，否则变更不生效 - 想持久化多目录结构，务必执行
Project → Save Project As…生成新的.sublime-project文件；仅靠Add Folder不保存到磁盘
临时诊断：绕过项目文件直接加载目录
当怀疑 .sublime-project 本身已损坏（比如 JSON 格式错、键名拼错、值类型不对），最快速验证方式是跳过它，直连物理路径。
- 关闭当前窗口，用命令行启动：
subl --project "" /path/to/your/folder（空 project 参数强制忽略项目文件） - 或在 Sublime 内：
Ctrl+Shift+P→Project: Add Folder to Project→ 选中根目录，观察侧边栏是否恢复 - 若能正常显示，说明问题出在
.sublime-project内容；此时可新建一个干净项目文件，逐条迁移folders和settings - 注意：
.sublime-workspace文件可能缓存旧路径状态，临时重命名它（如改为.sublime-workspace.bak）再试
真正难排查的不是路径写错了，而是 Sublime 对无效路径完全沉默——它既不报错也不留日志，只悄悄跳过。所以每次改完 .sublime-project，都得手动刷新视图并点开侧边栏确认子目录是否真实展开，不能只看左下角路径显示。
