.sublime-project 文件是 Sublime Text 项目配置核心，用于定义多项目独立环境。它以 JSON 格式记录项目文件夹路径、专属设置（如缩进、编码）、排除规则（folder_exclude_patterns、file_exclude_patterns）及绑定构建系统（如 npm 命令）。与之配套的 .sublime-workspace 文件保存用户会话数据（如打开标签、光标位置），通常不纳入版本控制。创建项目可通过 Project > Save Project As… 生成 .sublime-project 文件，添加文件夹后可保存结构，并通过 Switch Project 快速切换。项目文件置于根目录便于团队共享配置。高级用法支持多工作区，使用 New Workspace for Project 可为同一项目创建不同布局视图，适用于前后端分屏或分支对比。典型配置示例包含路径、排除项、缩进设置和自定义构建命令（如 npm run test），提升开发效率，避免重复配置，保持环境一致性。
Sublime Text 的 .sublime-project 文件是项目配置的核心，它不只是保存文件夹路径，而是定义了一个完整的工作环境。通过这个文件，你可以为不同项目独立设置打开的文件夹、窗口布局、排除规则、构建系统等，实现高效、个性化的多项目管理。
项目文件的基本作用
.sublime-project 是一个 JSON 格式的文件，用来存储项目的具体配置。它的主要功能包括：
- 记录项目包含的文件夹路径，下次可直接加载整个目录结构
- 保存项目专属的设置，比如缩进大小、换行符、编码格式等
- 定义哪些文件或目录应被侧边栏和搜索忽略（使用 folder_exclude_patterns 和 file_exclude_patterns）
- 绑定特定的构建系统（Build System），例如为某个项目指定运行 Python 脚本或 npm 命令
项目文件通常与同名的 .sublime-workspace 文件一起生成，后者保存的是用户在当前项目中的窗口状态、打开的标签页、光标位置等个人会话数据，一般不提交到版本控制中。
如何创建和使用项目
在 Sublime Text 中管理多个项目非常直观：
- 打开菜单 Project > Save Project As…，输入项目名称即可生成 .sublime-project 文件
- 添加文件夹：选择 Project > Add Folder to Project，然后可通过 Project > Save Project and Workspace As… 保存结构
- 切换项目：使用 Project > Switch Project 快速在不同项目间跳转
你也可以将项目文件放在项目根目录下，方便团队共享统一的编辑器配置。
工作区（Workspace）的高级用法
一个项目可以有多个工作区，适合复杂项目中需要不同视角的场景。例如：
通过 Project > New Workspace for Project 可为当前项目创建新的工作区视图，每个工作区可保存不同的窗格布局和打开文件。
实用配置示例
一个典型的 myproject.sublime-project 文件内容如下：
{
"folders": [
{
"path": ".",
"folder_exclude_patterns": ["node_modules", "dist"],
"file_exclude_patterns": ["*.log"]
}
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true
},
"build_systems": [
{
"name": "Run Tests",
"cmd": ["npm", "run", "test"],
"working_dir": "${project_path}"
}
]
}
这个配置指定了项目根目录为工作路径，排除常见冗余目录，设置缩进为 2 个空格，并添加了一个自定义测试命令。
基本上就这些。合理使用 .sublime-project 文件能极大提升开发效率，尤其在维护多个项目时，避免重复配置，保持环境一致。
