项目
版
Sublime Text 中的项目由两个文件组成:.sublime-project 文件,其中包含项目定义,以及 .sublime-workspace 文件,其中包含用户特定数据,例如打开的文件和每个文件的修改。
通常,.sublime-project 文件会被检入版本控制,而 .sublime-workspace 文件则不会。
项目格式🔗
.sublime-project 文件是 JSON 格式的,支持三个顶级部分:"folders"
,用于包含的文件夹,"settings"
,用于文件设置覆盖,以及 "build_systems"
,用于项目特定的构建系统。例如
{
"folders":
[
{
"path": "src",
"folder_exclude_patterns": ["backup"],
"follow_symlinks": true
},
{
"path": "docs",
"name": "Documentation",
"file_exclude_patterns": ["*.css"]
}
],
"settings":
{
"tab_size": 8
},
"build_systems":
[
{
"name": "List",
"shell_cmd": "ls -l"
}
]
}
"folders"
键🔗
"folders"
键包含一个对象数组。每个对象都必须有一个 "path"
键,它可以是相对于项目目录的路径,也可以是完全限定路径。
其他可选键包括
- "name" 字符串🔗
在侧边栏中用于代替文件夹名称的名称
- "file_include_patterns" 字符串 数组🔗
要从文件夹中包含的文件的模式。任何与这些模式不匹配的内容都将被排除在外。这将在
"file_exclude_patterns"
之前检查。
- "file_exclude_patterns" 字符串 数组🔗
要从文件夹中排除的文件的模式。这将添加到同名全局设置中。这将在
"file_include_patterns"
之后检查。
- "folder_include_patterns" 字符串 数组🔗
要从文件夹中包含的文件夹的模式。任何与这些模式不匹配的内容都将被排除在外。这将在
"folder_exclude_patterns"
之前检查。
- "folder_exclude_patterns" 字符串 数组🔗
要从文件夹中排除的文件夹的模式。这将添加到同名全局设置中。这将在
"folder_include_patterns"
之后检查。
- "binary_file_patterns" 字符串 数组🔗 3158
要视为二进制文件的模式,因此在“转到任何内容”和“在文件中查找”中将被忽略。
- "index_include_patterns" 字符串 数组🔗 3158
要编入索引的文件的模式。这将添加到同名全局设置中。任何与这些模式不匹配的内容都将从索引中排除。这将在
"index_exclude_patterns"
之前检查。
- "follow_symlinks" 布尔值🔗
构建文件夹树时是否应遵循符号链接。
从早期版本转换的项目可能在 "folders"
下有一个 "mount_points"
条目。如果您希望使用排除模式,则需要更改为上述格式。
"settings"
键🔗
Settings
可以使用 "settings"
键在此处指定,并将覆盖常规用户设置。但是,它们不会覆盖特定于语法的设置。
请注意,只有 编辑器设置 类别中的设置才能由项目控制。
"build_systems"
键🔗
"build_systems"
指定内联 构建系统 定义的列表。除了常规构建系统设置外,还必须为每个系统指定 "name"
。此处列出的构建系统将通过常规的 菜单提供。