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:\Users\abc\project或转义） - 如果文件夹是挂载的网络盘、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 osclass 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 还在用内存里缓存的老配置——直到你按下那组快捷键。
