Sublime Text 项目配置需手动创建和重载 .sublime-project 文件，改 settings 后必须执行 Project → Reload Project 或快捷键重载，仅保存无效；folders 为必填项且格式严格，路径须用正斜杠、UTF-8 编码、避免中文空格；多文件夹项目应通过 Add Folder to Project 添加并 Sa ve Project 持久化；.sublime-workspace 记录个人会话，应忽略 Git；插件是否读取项目设置取决于其是否调用 view.settings()。
先明确一个核心概念：Sublime Text 并没有传统IDE那种“自动维护”的项目工程。它的项目管理，完全依赖于一个需要你手动创建、手动加载、甚至手动重载的 .sublime-project 文件。这意味着，从文件路径到JSON格式，任何一个环节出错——比如字段写错、路径不对、或者忘记重载——你精心配置的设置都可能完全失效。
为什么改了 settings 却没反应？
这几乎是每个Sublime用户都会踩的坑。原因很简单：Sublime不会监听JSON文件的变更，更不会热更新配置。你兴冲冲地在 .sublime-project 里把 "tab_size" 改成2，或者关掉了 "spell_check"，然后保存，结果发现编辑器毫无变化。问题出在哪儿？你少了一个关键动作：主动触发项目重载。
具体操作路径有几种：
- 最直观的，从菜单栏点击
Project → Reload Project。 - 更高效的方式是使用快捷键
Ctrl+Alt+P（Windows/Linux）或Cmd+Alt+P（Mac），呼出命令面板后输入“Reload”并执行。
记住，仅仅保存 .sublime-project 文件是没用的。当然，重启Sublime Text也能达到同样效果，但显然没必要这么麻烦。如果重载后设置依然无效，那就得检查一下你的 settings 对象是不是放在了JSON的顶层，而不是错误地嵌套在了某个 folders 对象内部。
folders 字段写错会导致整个项目加载失败
folders 是 .sublime-project 文件里的必填项，而且格式要求极其严格。很多项目加载异常，根源都出在这里。下面这些情形，都会导致配置静默失效：
- 空数组陷阱：如果
"folders": []，Sublime会直接忽略这个项目文件，侧边栏一片空白。 - 路径分隔符用错：写成
"path": "C:\myproject"是不行的，必须统一使用正斜杠："path": "C:/myproject"。 - 路径不存在或拼写错误：比如把
"src"误写成"srce"。Sublime遇到这种情况会直接跳过该条目，不会报错，也不会给你任何提示。 - 文件名含特殊字符：项目文件本身（如
我的项目.sublime-project）如果包含中文或空格，也可能导致配置无法正常加载。 - 手动创建JSON的隐患：不建议直接新建一个空文件然后手动编写JSON。正确流程应该是通过
Project → Sa ve Project As…来创建。手动创建很容易遗漏字段、写错编码（必须是UTF-8）、或者少写逗号，从而引发一系列解析错误。
如何让多个不相关文件夹共存于一个项目？
实际开发中，我们经常需要同时管理多个独立的目录，比如前端的 frontend/ 和后端的 backend/。这时候，仅仅打开一个根目录是不够的。标准的操作流程应该是这样的：
- 首先，通过
File → Open Folder…打开第一个文件夹（例如frontend/）。 - 接着，使用
Project → Add Folder to Project来添加第二个文件夹（例如backend/）。 - 关键一步：添加完成后，务必执行
Project → Sa ve Project（注意不是Sa ve Project As…），将当前的项目结构持久化保存到.sublime-project文件中，否则重启Sublime后新增的文件夹就会消失。 - 每个
folder对象都可以独立设置属性，比如name（在侧边栏显示的名称）、folder_exclude_patterns、file_exclude_patterns等，实现精细化的管理。 - 路径的写法也有讲究：推荐使用变量如
"path": "${folder}"，或者相对路径"path": "."，尽量避免硬编码的绝对路径，这样项目文件在不同机器间共享会更方便。
.sublime-workspace 文件不该提交，但很多人误以为它是项目配置
这里需要厘清一个常见的误解。与 .sublime-project 配套生成的，通常还有一个 .sublime-workspace 文件，但两者的作用天差地别。
.sublime-workspace 记录的是纯粹的个人会话状态：你打开了哪些文件、光标在什么位置、窗口如何分屏、内置终端是否开启等等。它和团队共享的项目配置毫无关系。
因此，最佳实践是：
.sublime-project文件：应该提交到版本控制系统（如Git），确保团队成员拥有统一的项目结构、构建系统和编辑器设置。.sublime-workspace文件：务必添加到.gitignore中忽略掉。否则，你会把自己的临时编辑状态推送给所有同事，这显然不是我们想要的。
另外几个相关的注意点：
- 在侧边栏右键某个文件夹选择
Remove Folder from Project，这个操作只影响你当前的会话，并不会修改.sublime-project文件。要想永久移除，必须直接编辑JSON文件并重载项目。 - 插件能否读取你在项目文件中设置的配置，取决于插件本身的实现——它是否调用了
view.settings()来获取设置。 - 最后，像
color_scheme（配色方案）和theme（界面主题）这类全局性较强的设置，在项目文件中配置是会被Sublime直接忽略的，它们通常需要在用户全局设置中调整。
