最可靠方式是通过“Project → Save Project As…”生成合法JSON格式的.sublime-project文件，需确保已加载文件夹，且settings与project_settings字段不可混用，路径须为相对或绝对路径。
如何用 Sublime Text 正确创建 .sublime-project 文件
Sublime Text 的项目功能不靠图形界面按钮触发，而是依赖手动创建或自动生成的 .sublime-project 文件。直接点 “Project → Save Project As…” 是最可靠的方式，它会在你指定路径下生成一个 JSON 格式的项目文件，并自动关联当前打开的文件夹和设置。
常见错误是手动新建空文本再改后缀名——这样容易漏掉必需字段，导致项目无法加载或设置不生效。正确做法是：确保至少有一个文件夹已通过 File → Open Folder… 加载，再执行保存操作。
-
.sublime-project必须是合法 JSON，顶层必须是对象（即以{开头） - 若想让项目默认启用特定构建系统，需在
settings下加"build_system": "Python"（值为构建系统的名称，非文件名） - 路径中含中文或空格不会报错，但某些插件（如 Git 插件）可能解析异常，建议项目根目录用英文命名
project_settings 与 sublime-project 中 settings 的区别
很多人以为在 .sublime-project 里写 settings 就能覆盖全局配置，其实它只影响当前项目下的视图（view），而 project_settings 是另一个独立字段，专用于控制项目级行为（比如是否索引某些路径、是否启用特定插件功能）。
典型误用：把 "tab_size": 2 写进 project_settings —— 这个键只在 settings 下才生效；反过来，把 "index_files": false 写进 settings 则无效，必须放 project_settings。
-
settings：控制编辑器外观和行为（缩进、字体、折叠等），作用于所有打开的该项目的文件 -
project_settings：控制 Sublime 自身对项目的处理逻辑（索引范围、文件监听、插件开关等） - 两者可共存，但不能嵌套或混用键名；Sublime 启动时会合并它们，冲突时以
project_settings优先
多文件夹项目（"folders" 数组）的路径陷阱
一个 .sublime-project 可以同时管理多个不相关的文件夹，靠 folders 数组实现。但每个 path 值必须是相对于项目文件本身的相对路径，或绝对路径；不能是 Sublime 启动时的工作目录路径，也不能是环境变量（如 $HOME）。
现象：添加了 "path": "src" 却提示 “folder not found”，实际是因为项目文件放在 /Users/me/myproj/，而 src 其实在 /Users/me/myproj/backend/src —— 这时应写 "path": "backend/src"。
- 推荐统一用相对路径，避免跨机器迁移失败
- 路径末尾不要加斜杠（
"path": "lib/"是错的，应为"path": "lib"） - 若某个文件夹临时不想被索引，可加
"follow_symlinks": false或设"file_exclude_patterns"屏蔽
用命令行快速切换项目（subl -n --project）
Sublime Text 命令行工具 subl 支持直接加载项目，比 GUI 点击快得多。关键参数是 --project，后面跟 .sublime-project 的完整路径（不是文件夹路径）。
容易卡住的情况：执行 subl --project myproj.sublime-project 没反应，其实是路径错了——它不接受相对路径，除非你在项目文件所在目录下运行；更稳妥的是用绝对路径：subl --project /full/path/to/myproj.sublime-project。
- 加
-n参数可强制新建窗口，避免项目被加载到已有窗口中干扰其他工作区 - 如果项目文件名不含
.sublime-project后缀（比如只叫myproj），Sublime 会静默忽略，不会报错也不会加载 - Windows 用户注意：PowerShell 中路径含空格需用引号包裹，CMD 则不需要
.sublime-project，之后修改文件内容不会实时生效，必须重启窗口或重新执行 Project → Open Project…。这点常被忽略，导致调了半天配置却始终不生效。 
