.sublime-project 文件必须通过 project → save project as… 创建并保存在项目根目录，路径不能含中文或空格，folders 字段必填且格式严格，修改 settings 后需手动重载项目才生效。
Sublime Text 的 .sublime-project 不是“自动生效的配置”，它必须手动保存、路径正确、JSON 合法，且修改后需重载才起作用——否则你改了 tab_size 也看不到效果。
Project → Save Project As… 是唯一可靠创建方式
别手动生成空 JSON 文件，也别指望 “Open Folder” 就算项目。Sublime 只认通过菜单显式保存的 .sublime-project：
- 必须用 Project → Save Project As… 触发保存流程，不能靠复制粘贴或新建文本再改后缀
- 文件名必须以
.sublime-project结尾，不能是project.json或myapp.project - 推荐保存到项目根目录下，路径里不能含中文、空格或特殊符号（如
我的项目.sublime-project会静默失败） - 保存后窗口标题栏会立刻显示项目名，这是判断是否成功的最直观信号
folders 字段写错会导致整个项目加载失败
folders 是必填项，且格式容错极低。常见失效原因包括：
- 路径用了反斜杠
\（Windows 下也必须用正斜杠/，例如"path": "src/utils"） -
folders值为空数组[]或字段缺失，Sublime 直接忽略该文件，不报错也不提示 - 路径不存在或拼写错误（比如
"path": "srce"），Sublime 静默跳过，侧边栏空白但无提示 - 排除模式大小写敏感：
"folder_exclude_patterns": ["Node_modules"]不会匹配node_modules
验证方法：保存后立即点 Project → Reload Project，看底部状态栏是否提示 Invalid project file；没有提示 ≠ 有效。
settings 修改后不会热更新，必须重载或重启
你在 .sublime-project 的 settings 里改了 tab_size、spell_check 或 syntax，这些设置不会在保存文件后自动应用：
- 必须手动执行 Project → Reload Project（快捷键
Ctrl+Alt+P/Cmd+Alt+P，再搜 “Reload”） - 如果重载后仍不生效，检查
settings是否嵌套在正确层级——它必须是顶层 key，不能缩进错位或包在其他对象里 -
color_scheme和theme在.sublime-project中被完全忽略，控制台会输出Ignoring invalid project setting: color_scheme，这不是 bug - 插件设置是否生效，取决于插件本身是否读取
view.settings()；可临时加个测试字段如"my_test": true，然后在 Python 控制台运行sublime.active_window().active_view().settings().get("my_test")验证
build_systems 和 exclude_patterns 只影响当前项目上下文
build_systems 和 folder_exclude_patterns 这类配置，只在你通过 Project → Open Project… 加载该 .sublime-project 时才激活：
- 用
File → Open Folder…打开目录，即使目录下有.sublime-project，也不会加载其中的build_systems或settings -
folder_exclude_patterns只控制侧边栏显示，Ctrl+Shift+F全局搜索仍会扫被排除的目录（如node_modules） - 多个
folders条目可共存，但每个folder_exclude_patterns仅作用于对应path下的子树，不是全局过滤 -
build_systems中的变量如${project_path}指向的是第一个folders[0].path，不是任意文件所在位置
最易被忽略的一点：.sublime-workspace 文件保存的是窗口状态（打开的标签页、光标位置等），它默认不提交 Git，但 .sublime-project 应该提交——尤其当含 build_systems 或团队统一 tab_size 时。
