.sublime-project 文件是 Sublime Text 中用于定义项目结构和配置的 JSON 文件，支持管理多文件夹、设置专属编辑选项并提升开发效率。
Sublime Text 的项目文件（.sublime-project）是管理多个文件夹、设置专属配置和快速切换工作环境的核心工具。掌握它的使用方法，能大幅提升开发效率。
什么是 .sublime-project 文件
这是一个 JSON 格式的配置文件，保存了当前项目的文件夹路径、窗口布局、排除规则以及特定的编辑设置。它通常与一个同名的 .sublime-workspace 文件一起生成，后者记录了用户的会话状态（如打开的标签页、光标位置等），而 project 文件更偏向结构定义。
如何创建项目文件
打开 Sublime Text，按以下步骤操作：
- 点击顶部菜单栏的 Project → Save Project As…
- 输入项目名称并保存，系统会自动生成一个 .sublime-project 文件
- 该文件默认包含你当前添加到侧边栏的所有文件夹
也可以手动创建：新建一个文本文件，命名为 项目名.sublime-project，写入基本结构：
{
"folders": [
{
"path": "/Users/yourname/dev/myproject",
"folder_exclude_patterns": [".git", "node_modules"]
}
]
}
项目文件常用配置项
通过编辑 .sublime-project 文件，可以精细化控制项目行为：
2013年07月06日 V1.60 升级包更新方式：admin文件夹改成你后台目录名，然后补丁包里的所有文件覆盖进去。1.[新增]后台引导页加入非IE浏览器提示，后台部分功能在非IE浏览器下可能没法使用2.[改进]淘客商品管理 首页 列表页 内容页 的下拉项加入颜色来区别不同项3.[改进]后台新增/修改淘客商品，增加淘宝字样的图标和天猫字样图标改成天猫logo图标4.[改进]为统一名称，“分类”改
- path：指定项目根目录路径
- folder_exclude_patterns：忽略某些文件夹（如日志、依赖包）
- file_exclude_patterns：过滤特定类型文件（如 *.tmp）
- settings：为该项目单独设置缩进、换行、编译命令等
例如，为前端项目定制设置：
{
"folders": [
{
"path": ".",
"folder_exclude_patterns": ["dist", "build"],
"file_exclude_patterns": ["*.log"]
}
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true,
"draw_white_space": "all"
}
}
多项目快速切换
使用快捷键 Ctrl+Alt+P（macOS 为 Cmd+Opt+P）可快速在不同项目间切换。前提是已通过 Project → Add Folder to Project 添加过多个项目，或使用 Project → Open Project 加载了其他 .sublime-project 文件。
还可以配合 Project → Switch Project 菜单查看最近使用的项目列表，实现一键跳转。
实用技巧与建议
- 将 .sublime-project 文件纳入版本控制（如 Git），便于团队统一开发环境
- 不建议提交 .sublime-workspace 文件，因其包含个人操作状态
- 可在项目根目录直接右键选择“Open with Sublime Text”快速加载整个项目
- 结合 SideBarEnhancements 插件，能更方便地管理项目文件
基本上就这些。合理使用项目文件，能让 Sublime Text 更像一个轻量级 IDE，适应不同类型的开发任务。
