Project → Reload Project 是最直接解法，sublime Text 不自动监听 .sublime-project 文件变更，需手动重载才能刷新项目结构、设置与构建系统，且不关闭已开标签页。

sublime text 项目文件没更新？Project → Reload Project 是最直接解法

Sublime Text 不会自动监听磁盘上 .sublime-project 文件的变更，改完配置后不手动重载，窗口里看到的项目结构、设置、构建系统都还是旧的。这不是 bug，是设计如此——它只在启动时读一次项目文件。

• Project → Reload Project（快捷键 Ctrl+Alt+P / Cmd+Alt+P）能立刻重新解析当前项目的 .sublime-project，刷新文件夹视图、设置、插件行为等，且不关闭任何已打开的标签页或侧边栏
• 如果项目没显式保存过项目文件（即靠“添加文件夹到项目”临时建的），菜单项会显示为 Save Project As…，此时先存一个 .sublime-project，之后才能用 Reload Project
• 注意：重载不会恢复你手动从侧边栏拖走/隐藏的文件夹；那些操作是 ui 状态，不写入项目文件，重载后它们会按 "folders": [...] 配置重新出现

为什么改了 "folders" 却没生效？检查路径和权限

重载后文件夹仍不显示，大概率是 .sublime-project 里的路径写错了，或者 Sublime 没权限访问目标目录。

• 路径必须是绝对路径（windows 用 C:\path\to\folder 或 C:/path/to/folder，macOS/linux 用 /Users/name/project），相对路径不被支持
• 路径中不能有多余空格或中文（尤其 windows 下带空格的用户目录，建议用短路径如 C:Usersabcproject 或转义）
• 如果文件夹是挂载的网络盘、WSL 路径或 docker volume，确认 Sublime 启动时能访问该位置——比如从 macOS Finder 启动 Sublime，它默认无权读取 /mnt/wsl
• 可临时在终端里运行 subl --project /path/to/project.sublime-project 测试是否能正确加载

想自动响应项目文件变更？得靠插件 + 文件系统监听

原生 Sublime 不支持自动重载项目，但可用 AutoSetSyntax 或自定义插件实现近似效果。不过要注意副作用：

• 频繁重载可能中断正在编辑的文件状态（如光标位置、折叠状态），尤其当项目含大量文件时
• 推荐做法是：开发中把 .sublime-project 当配置文件管理，配合 git 提交；日常修改后手动按一次 Ctrl+Alt+P，比自动化更可控
• 若坚持自动，可用 sublime_plugin.EventListener 监听 on_post_save，判断保存的是 .sublime-project 后再调用 window.run_command("reload_project") ——但需自行处理并发重载、错误提示等边界情况

import sublime import sublime_plugin import os 
class AutoReloadProjectListener(sublime_plugin.EventListener): def on_post_save(self, view): if view.file_name() and view.file_name().endswith('.sublime-project'): window = view.window() if window and window.project_file_name():
避免重复触发
            window.run_command("reload_project")
重载失败却没报错？查 Sublime Text console 里的真实错误
点击 View → Show Console（或 Ctrl+`），重载后立即看输出。常见静默失败原因：

 Unable to open project file：路径拼错，或文件被其他程序占用（如 VS Code 正在编辑同一文件）
 Invalid project file format：jsON 格式错误，比如末尾多逗号、引号不闭合、用了单引号
 No such file or Directory：某个 "path" 指向的文件夹已被删除或移动，Sublime 不会跳过，直接停止加载整个项目
控制台没输出？说明重载成功了——只是你的改动本身没起作用（比如改的是未启用的 "settings" 块，或插件未监听该项目级配置）

项目配置不是“改完就生效”的类型，它依赖一次明确的重载动作。最容易被忽略的是：你以为改了路径就能立刻看到新文件夹，其实 Sublime 还在用内存里缓存的老配置——直到你按下那组快捷键。