创建和保存 Sublime 的 .sublime-project 文件需通过菜单 Project → Save Project As… 保存为 xxx.sublime-project，必须用 UTF-8 编码，folders 为必填项且路径用正斜杠；修改后须手动 Reload Project 才生效。
怎么创建和保存 Sublime 的 .sublime-project 文件
Sublime 的 Project 功能本质就是靠一个 JSON 配置文件驱动，名字必须是 xxx.sublime-project，不能叫 project.json 或漏掉 .sublime- 前缀。它通常和项目根目录放一起，但也可以放在别处——只要通过菜单打开就行。
最稳妥的方式是：打开项目文件夹 → 菜单栏 Project → Save Project As… → 选在项目根目录下保存为 myapp.sublime-project。别手动生成空文件再填内容，容易格式出错或编码不兼容（比如用了中文引号、多了逗号）。
- 必须用 UTF-8 编码保存，否则 Sublime 可能静默忽略该文件
-
"folders"是必填项，哪怕只写一个路径；空数组[]或缺字段都会导致项目加载失败 - 路径用正斜杠
/，Windows 下也别用反斜杠\，否则某些版本会解析失败
如何让 folders 正确包含子目录和排除临时文件
"folders" 不只是“加个路径”，它控制文件树视图显示范围和搜索/替换的作用域。默认递归包含所有子目录，但常需要过滤 node_modules、__pycache__、build/ 这类干扰项。
关键不是靠系统级忽略，而是写进项目配置的 "folder_exclude_patterns" 和 "file_exclude_patterns"。它们只对当前 project 生效，不影响全局设置或别的项目。
-
"folder_exclude_patterns": ["node_modules", ".git", "dist"]—— 排除整个文件夹（注意不带尾部/） -
"file_exclude_patterns": ["*.log", "*.tmp"]—— 排除匹配的文件，支持通配符 - 排除模式区分大小写，
"*.PY"不会匹配main.py；建议全小写写法更稳
为什么改了 .sublime-project 文件，侧边栏没刷新
Sublime 不监听项目文件变更，改完 JSON 后不会自动重载。常见现象是：删了某个 folder_exclude_patterns 条目，但侧边栏里 node_modules 还是灰的；或者加了新路径，但文件树没出现。
必须手动触发重载：菜单栏 Project → Reload Project，或者关掉当前窗口再重新用 Project → Open Project… 打开。快捷键 Ctrl+Alt+P（Win/Linux）或 Cmd+Alt+P（Mac）能快速唤出命令面板搜 “Reload”。
- 不要依赖 “Save” 后自动生效 —— 它真不会
- 如果重载后仍不显示，检查 JSON 是否有语法错误（Sublime 底部状态栏会提示
Invalid project file） - 路径写错时不会报错，只会静默跳过那个
folder，务必核对拼写和斜杠方向
多个项目共用同一份代码时，怎么避免配置冲突
比如你同时维护 frontend/ 和 backend/，但它们共享 shared-utils/。直接把两个根目录都塞进同一个 "folders" 数组，会导致搜索结果混杂、跳转定位不准。
正确做法是：拆成两个独立 project 文件，各自专注一个上下文。需要跨项目跳转时，用 Ctrl+P 搜索文件名，或装插件 Project Manager 快速切换。别试图在一个 project 里硬塞多个逻辑无关的根目录。
- Sublime 的
"folders"是扁平结构，没有“主次”或“优先级”，所有路径平等参与搜索和索引 - 共享目录若被重复加入不同 project，可能引发符号跳转混乱（比如
Ctrl+Click跳到错误副本） - 真要关联，用软链接（Linux/macOS）或 junction（Windows）把共享目录挂进各项目下，比在 project 配置里堆路径干净得多
Project 文件看着简单，但路径写法、JSON 格式、重载时机这三点最容易卡人。尤其是团队协作时，有人用绝对路径、有人用相对路径，一拉代码就失效——统一用相对于 project 文件自身的相对路径，是最少意外的选择。
