创建Sublime项目需通过Project → Save Project As…生成.sublime-project文件,用于定义多文件夹结构、专属设置与构建系统;该JSON文件可配置路径、排除规则、编辑偏好及运行命令,并建议提交至版本控制以协同开发。

在 Sublime Text 中创建一个项目,能帮助你高效管理多个文件夹和文件,特别适合处理大型工程或跨目录协作开发。项目的核心是 .sublime-project 文件,它不仅保存工作区结构,还能配置专属的构建系统、排除规则和窗口布局。
如何创建一个 Sublime 项目
你可以通过以下步骤快速创建一个项目:
- 打开 Sublime Text
- 点击顶部菜单栏的 Project → Save Project As…
- 选择保存位置,输入项目名称(如 myproject.sublime-project)
- 保存后,Sublime 会自动生成同名的 .sublime-workspace 文件(可选,用于保存本地工作区状态)
保存后,当前打开的文件夹会作为项目的一部分。你也可以后续通过 Project → Edit Project 来手动编辑项目配置。
.sublime-project 文件的作用
这个 JSON 格式的文件主要作用包括:
- 定义项目包含的文件夹路径:可以添加多个根目录,方便跨路径查看文件
- 设置特定于项目的首选项:比如缩进大小、换行符、编码格式等
- 配置构建系统(Build System):为项目指定专用的编译或运行命令
- 控制侧边栏显示内容:通过 patterns 排除某些文件或目录
- 支持多窗口布局和标签分组:配合 .sublime-workspace 使用
常见的 .sublime-project 配置示例
打开 Project → Edit Project 可编辑项目配置,下面是一个典型例子:
{
"folders": [
{
"path": "/Users/you/project/src",
"name": "Source Code",
"folder_exclude_patterns": [".git", "node_modules", "__pycache__"],
"file_exclude_patterns": ["*.log", "*.tmp"]
},
{
"path": "/Users/you/project/docs",
"name": "Documentation"
}
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true,
"trim_automatic_white_space": true
},
"build_systems": [
{
"name": "Run Python Script",
"cmd": ["python", "${file}"],
"selector": "source.python",
"working_dir": "${file_path}"
}
]
}
说明:
- folders 定义了项目中包含的目录,可重命名显示名称
- folder_exclude_patterns / file_exclude_patterns 控制侧边栏隐藏哪些内容
- settings 设置该项目独有的编辑行为
- build_systems 添加自定义运行命令,比如运行当前 Python 脚本
小贴士与使用建议
实际使用中注意这些细节:
- .sublime-project 文件应随代码一起提交到版本控制(如 Git),以便团队共享结构
- .sublime-workspace 文件通常不提交,因为它包含个人窗口状态
- 可以用快捷键 Ctrl+Alt+P(Windows/Linux)或 Cmd+Ctrl+P(Mac)快速切换项目
- 项目配置中的路径支持变量,如 ${project_path}、${file} 等
基本上就这些。合理使用项目功能,能让 Sublime Text 更像一个轻量级 IDE,尤其适合前端、脚本语言或混合技术栈的开发场景。










