.sublime-project文件是JSON格式的项目配置文件，用于为Sublime Text项目独立设置文件夹路径、语法高亮、构建系统等。通过“Project → Add Folder to Project”添加目录，再使用“Save Project As…”保存，自动生成.project文件；随后可通过“Edit Project”编辑配置。其核心结构包含folders（定义项目目录及排除规则）、settings（覆盖全局编辑设置如tab_size、rulers）和build_systems（定制构建命令，如Python运行）。利用变量如$project_path可提升配置灵活性，建议将.project文件纳入版本控制以统一团队开发环境，而忽略.workspace文件避免个人状态冲突。此举实现“一项目一配置”，显著提升开发效率。
在 Sublime Text 中，为项目创建专属的 .sublime-project 配置文件，可以让你针对不同项目独立设置语法高亮、构建系统、文件夹路径、排除规则等。这样切换项目时，编辑器会自动加载对应的配置，极大提升开发效率。
什么是 .sublime-project 文件？
一个 .sublime-project 文件是一个 JSON 格式的配置文件，用于保存某个项目的特定设置。它通常与同名的 .sublime-workspace 文件一起生成（后者保存用户相关的工作区状态，如打开的文件、光标位置等）。
如何为项目创建专属设置
步骤如下：
- 打开文件夹作为项目：在 Sublime Text 中，点击菜单栏 “Project” → “Add Folder to Project”，添加你当前工作的目录。
-
保存项目：点击 “Project” → “Save Project As…”，输入项目名称（例如
myweb.sublime-project），Sublime 会自动生成该项目配置文件。 - 编辑配置文件：通过 “Project” → “Edit Project” 打开 JSON 配置进行修改。
sublime-project 配置文件详解
以下是一个典型的 .sublime-project 文件结构示例，并附说明：
{
"folders": [
{
"path": "src",
"folder_exclude_patterns": [".git", "node_modules", "__pycache__"],
"file_exclude_patterns": ["*.log", "*.tmp"],
"follow_symlinks": true,
"name": "源代码目录"
},
{
"path": "../docs",
"name": "项目文档"
}
],
"settings": {
"tab_size": 2,
"translate_tabs_to_spaces": true,
"word_wrap": false,
"rulers": [80]
},
"build_systems": [
{
"name": "Build Python Script",
"cmd": ["python", "$file"],
"selector": "source.python",
"working_dir": "$file_path"
}
]
}
folders 字段说明
定义项目包含的文件夹及其行为：
- path：文件夹路径，相对或绝对均可。
- name：在侧边栏中显示的自定义名称。
- folder_exclude_patterns：忽略的文件夹名模式。
- file_exclude_patterns：忽略的文件扩展或名称模式。
- follow_symlinks：是否追踪符号链接，默认 false。
settings 字段说明
设置该项目下的编辑器偏好，覆盖全局设置：
- tab_size：缩进空格数。
- translate_tabs_to_spaces：是否将 Tab 转为空格。
- word_wrap：是否自动换行。
- rulers：垂直参考线位置（如代码宽度限制）。
build_systems 字段说明
为项目定制构建命令，适合不同语言环境：
- name：构建系统的名称，出现在 Tools → Build System 菜单中。
-
cmd：执行的命令数组，支持变量如
$file、$file_path。 - selector：关联的语法类型，Sublime 自动识别何时启用该构建系统。
- working_dir：命令执行的工作目录。
实用技巧
- 使用
$project_path变量引用项目根目录，便于跨平台配置。 - 配合
.sublime-build文件可进一步模块化构建系统。 - 提交
.sublime-project到版本控制（如 Git），方便团队统一开发环境。 - 不希望共享个人状态？则忽略
.sublime-workspace文件。
基本上就这些。合理使用 .sublime-project 文件，能让 Sublime Text 更智能地服务于你的每一个项目，真正做到“一项目一配置”。
