通过创建和编辑 .sublime-project 文件可为项目设置独立配置,支持自定义缩进、排除文件夹、构建系统等;该文件为 JSON 格式,包含 folders 和 settings 字段,其中 settings 用于定义项目专属设置;配置优先级顺序为:项目设置 > 语法专用设置 > 用户设置 > 默认设置,确保项目配置覆盖全局。

在 Sublime Text 中为单个项目设置独立的配置,可以通过项目专属的 .sublime-project 文件实现。这种方式允许你为不同项目自定义语法高亮、构建系统、排除文件夹、缩进规则等,而不会影响其他项目。
1. 创建项目并生成 .subime-project 文件
如果你还没有项目文件:
- 打开 Sublime Text,点击顶部菜单栏的 Project → Save Project As…
- 将项目保存为
your-project-name.sublime-project - 保存后会自动生成一个同名的项目配置文件
该文件本质是一个 JSON 格式的配置文件,你可以编辑它来添加个性化设置。
2. 编辑项目配置文件
右键项目根目录或通过 Project → Edit Project 打开 .sublime-project 文件进行编辑。基本结构如下:
{
"folders": [
{
"path": "."
}
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true,
"trim_automatic_white_space": true,
"word_wrap": false
}
}
其中 settings 字段就是项目专属的配置。支持大多数常规的编辑器设置。
3. 常用项目级配置示例
可以在 "settings": {} 中加入以下内容:
- 缩进设置:针对前端项目使用 2 个空格,后端用 4
-
文件排除:
"folder_exclude_patterns": [".git", "node_modules", "__pycache__"]
-
构建系统指定:
"build_systems": [ { "name": "Python - Custom", "cmd": ["python", "$file"], "selector": "source.python" } ] -
语法绑定(如特定路径下的文件自动用某语法):
"syntax_map": { "src/js": "JavaScript" }
4. 配置优先级说明
Sublime 的配置优先级从高到低是:
- 项目设置(.sublime-project)→ 最高优先级
- 文件语法专用设置(如 Preferences → Settings - Syntax)
- 用户设置(Preferences → Settings)→ 全局默认
这意味着项目中的设置会覆盖用户的全局设置,实现真正的“独立配置”。
基本上就这些。只要正确使用 .sublime-project 文件中的 settings 字段,就能轻松为每个项目定制专属行为,提升开发效率。










