跳至内容

项目

另请参阅

项目文档 : 解释如何使用项目。

项目官方文档 : 可能提供更最新的详细信息。

项目信息保存在元数据文件中,可以编辑这些文件以允许高级配置,而不仅仅是添加或删除文件夹。要通过**项目 → 编辑项目**菜单编辑当前活动项目的项目文件。匿名项目无法以任何方式配置,因为不存在与之关联的 .sublime-project 文件。

文件格式

格式描述
格式JSON(带注释)
扩展名.sublime-project
名称任意
位置文件系统中的任何位置
内容项目的元数据

示例

项目元数据分为三个最顶层的节

  • folders,用于包含的文件夹;
  • settings,用于项目特定的设置;以及
  • build_systems,用于项目特定的构建系统。
json
{
    "folders":
    [
        {
            "path": "src",
            "folder_exclude_patterns": ["backup"]
        },
        {
            "path": "docs",
            "name": "Documentation",
            "file_exclude_patterns": ["*.css"]
        }
    ],
    "settings":
    {
        "tab_size": 8
    },
    "build_systems":
    [
        {
            "name": "List",
            "cmd": ["ls"]
        }
    ]
}

文件夹

将在侧边栏中列出的文件夹列表,并定义项目范围。

模式优先级

包含模式首先应用,有效地排除了与它们不匹配的所有内容。之后,排除模式将进一步从项目中排除文件或文件夹。

path : **必需**

路径可以相对于项目目录或绝对路径。使用 . 表示项目文件所在的目录。

name : **可选**

如果存在,它将出现在侧边栏中,而不是目录名称。

folder_exclude_patterns : **可选**

通配符模式列表。与通配符模式匹配的文件夹将从项目中排除。

folder_include_patterns : **可选**

通配符模式列表。与通配符模式匹配的文件夹将包含在项目中。

file_exclude_patterns : **可选**

通配符模式列表。与通配符模式匹配的文件将从项目中排除。

file_include_patterns : **可选**

通配符模式列表。与通配符模式匹配的文件将包含在项目中。

follow_symlinks : **可选**

如果启用,将为路径解析跟踪符号链接。

示例

json
{
    "folders":
    [
        {
            "path": ".",
            "folder_include_patterns": ["foo"],
            "file_exclude_patterns": ["*.html"]
        },
        {
            "path": "foo",
            "name": "foo <with HTML files>"
        }
    ]
}

设置

项目可以定义项目特定的设置,这些设置仅适用于该项目中的文件。项目特定的设置会覆盖用户设置,但不会覆盖语法特定的设置。

几乎所有设置都可以覆盖(不包括全局设置)。

另请参阅

设置层次结构 : 设置优先级顺序的详细示例。

设置参考 : 可用设置的参考。

构建系统

您可以在 .sublime-project 文件中定义特定于项目的构建系统。项目中的构建系统遵循与传统构建系统相同的规则,但必须为每个构建系统指定一个 name。它们将显示在 工具 → 构建系统 菜单中,并且可以在 使用构建 弹出窗口中选择,但仅限于该项目。

另请参阅

构建系统参考 : 关于构建系统及其选项的文档。