项目

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" 之前检查。

"index_exclude_patterns" 字符串 数组🔗
3158

文件模式,用于从文件夹索引中排除。这将添加到同名的全局设置中。这将在 "index_include_patterns" 之后检查。

构建文件夹树时是否应遵循符号链接。

从早期版本转换的项目可能在 "folders" 下有一个 "mount_points" 条目。如果您希望使用排除模式,则需要更改为上述格式。

"settings"🔗

Settings 可以使用 "settings" 键在此处指定,并将覆盖常规用户设置。但是,它们不会覆盖特定于语法的设置。

请注意,只有 编辑器设置 类别中的设置才能由项目控制。

"build_systems"🔗

"build_systems" 指定内联 构建系统 定义的列表。除了常规构建系统设置外,还必须为每个系统指定 "name"。此处列出的构建系统将通过常规的 工具 ▶ 构建系统 菜单提供。