正确创建并保存Sublime项目需先通过File→Open Folder…打开至少一个文件夹，再执行Project→Save Project As…生成.sublime-project文件，且应存于项目根目录；添加多文件夹须用Add Folder to Project并再次Save Project以持久化配置。
如何正确创建并保存一个 Sublime 项目文件
Sublime 的项目管理不是靠“新建项目”菜单启动的，而是靠 Project → Save Project As… 这一动作真正落地。它不创建空壳，而是把当前已打开的文件夹（或多个文件夹）固化成一个可复用、可共享的配置。
- 必须先打开至少一个文件夹（
File → Open Folder…），再执行Save Project As…，否则生成的.sublime-project里folders数组为空，项目无法加载任何文件 - 强烈建议把
.sublime-project文件保存在项目根目录下，例如myapp/myapp.sublime-project，这样路径写"path": "."就能稳定指向整个项目，避免硬编码绝对路径导致换机器失效 - 保存后会同时生成同名的
.sublime-workspace文件——它记录的是你上次关掉窗口时打开了哪些标签页、光标在哪、分屏怎么排的，属于个人状态，**不该提交到 Git**
怎么在一个项目里管理多个不相关的文件夹
比如前端工程中要同时查看 src/ 和 dist/，或者微服务项目里想并列打开 backend/ 和 frontend/，这时不能只靠“打开一个根目录”，得主动添加。
- 右键侧边栏空白处 →
Add Folder to Project，或使用菜单Project → Add Folder to Project - 每个添加的文件夹在
.sublime-project中表现为folders数组里的一个对象，支持独立设置folder_exclude_patterns和file_exclude_patterns - 注意：添加后必须再次执行
Project → Save Project（不是Save Project As…）才能把新增文件夹写入配置，否则重启 Sublime 就丢失
为什么改了 settings 却没生效？常见覆盖逻辑误区
项目级 settings 看似简单，但优先级规则容易被误读：它高于用户级 Preferences.sublime-settings，但低于文件内语法专属设置（比如你右下角手动点了 “Indent Using Spaces”）。
- 验证是否生效：打开项目内任意文件，点击底部状态栏的
Tab Size或Indent Using Spaces，如果显示Project Override才算成功 - 别在
settings里写错字段名，例如"encoding"是旧版写法，新版应为"default_encoding"；"word_wrap"要写布尔值true/false，不能写字符串"true" - 插件配置也走这里，比如让 ESLint 只在当前项目启用：
"SublimeLinter.linters.eslint.disable": false，但前提是插件本身支持项目级键名
重建索引失败、侧边栏不更新？别忽略 Rebuild Index
当你增删了大量文件、切换 Git 分支、或修改了 folder_exclude_patterns 后，侧边栏仍显示旧文件或搜不到新文件，大概率是索引没刷新。
- 手动触发：
Project → Rebuild Index，等待右下角提示 “Indexing…” 完成，这是最直接有效的解决方式 - 不要依赖重启 Sublime：它不会自动重建索引，尤其在大项目（>10k 文件）中，索引可能卡在后台静默失败
- 如果重建后仍异常，检查
folder_exclude_patterns是否误写了正则语法（它只支持 glob 模式，不支持正则），例如"*.log"正确，而"^.*\.log$"会被忽略
.sublime-project 都要确认是否已 Save Project，而不是只改了文件却忘了持久化到项目定义里。 
