通过.sublime-project文件可为sublime text项目设置独立配置,包括文件结构、编辑设置、构建系统等,保存项目后生成.project和可选.workspace文件,编辑.project文件可定义folders、settings、build_systems等参数,实现项目级个性化配置,且支持团队共享与版本控制。

在 Sublime Text 中,为不同项目设置独立的配置是通过 .sublime-project 文件实现的。这个文件不仅能保存项目结构,还能定义项目专属的设置,比如语法高亮、构建系统、排除路径、缩进规则等。
创建项目并生成 .subime-project 文件
要为某个项目启用专属配置,先创建一个项目:
- 打开 Sublime Text
- 点击菜单栏的 Project → Save Project As…
- 将项目保存到项目根目录下,例如:myproject.sublime-project
保存后会生成两个文件:
- myproject.sublime-project:定义项目内容和设置
- myproject.sublime-workspace(可选):保存窗口布局、打开的文件等状态,通常不提交到版本控制
编辑 .sublime-project 配置
右键项目根目录或使用菜单 Project → Edit Project,打开 jsON 格式的项目配置文件。基本结构如下:
{ “folders”: [ { “path”: “.”, “folder_exclude_patterns”: [“.git“, “node_modules”], “file_exclude_patterns”: [“*.log”] } ], “settings”: { “tab_size”: 2, “translate_tabs_to_spaces”: true, “draw_white_space”: “all”, “word_wrap”: false }, “build_systems”: [ { “name”: “Run python”, “cmd”: [“python“, “$file”], “working_dir”: “${project_path}”, “selector”: “source.python” } ] }
说明:
- folders:定义项目包含的目录,“path”: “.” 表示当前目录
- folder_exclude_patterns / file_exclude_patterns:自定义排除项,不影响全局设置
- settings:项目级别的编辑器设置,优先级高于用户和语法默认设置
- build_systems:为项目定制构建命令,比如运行脚本、编译等
常用项目设置示例
你可以根据项目需求添加特定配置:
- 针对前端项目调整 JS 缩进: “tab_size”: 2, “js_indent”: true
- 禁用拼写检查: “spell_check”: false
- 指定默认语法: “default_extension”: “jsx”
- 设置环境变量(配合插件使用): “env”: {“node_ENV”: “development”}
注意事项
项目设置只在该项目打开时生效。关闭项目或打开其他文件夹时,Sublime 会自动切换回全局或语法默认设置。
- 确保 .sublime-project 文件放在项目根目录,方便团队共享
- 建议将该文件加入版本控制(如 git),以便协作统一配置
- 如果不想共享个人工作区状态,忽略 .sublime-workspace 文件
基本上就这些。通过合理使用 .sublime-project,可以让每个项目拥有独立的行为习惯,提升开发效率。