项目
项目信息保存在元数据文件中,可以编辑这些文件以允许高级配置,而不仅仅是添加或删除文件夹。要通过**项目 → 编辑项目**菜单编辑当前活动项目的项目文件。匿名项目无法以任何方式配置,因为不存在与之关联的 .sublime-project 文件。
文件格式
格式 | 描述 |
---|---|
格式 | JSON(带注释) |
扩展名 | .sublime-project |
名称 | 任意 |
位置 | 文件系统中的任何位置 |
内容 | 项目的元数据 |
示例
项目元数据分为三个最顶层的节
folders
,用于包含的文件夹;settings
,用于项目特定的设置;以及build_systems
,用于项目特定的构建系统。
{
"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
: **可选**
如果启用,将为路径解析跟踪符号链接。
示例
{
"folders":
[
{
"path": ".",
"folder_include_patterns": ["foo"],
"file_exclude_patterns": ["*.html"]
},
{
"path": "foo",
"name": "foo <with HTML files>"
}
]
}
设置
项目可以定义项目特定的设置,这些设置仅适用于该项目中的文件。项目特定的设置会覆盖用户设置,但不会覆盖语法特定的设置。
几乎所有设置都可以覆盖(不包括全局设置)。
构建系统
您可以在 .sublime-project
文件中定义特定于项目的构建系统。项目中的构建系统遵循与传统构建系统相同的规则,但必须为每个构建系统指定一个 name
。它们将显示在 工具 → 构建系统 菜单中,并且可以在 使用构建 弹出窗口中选择,但仅限于该项目。
另请参阅
构建系统参考 : 关于构建系统及其选项的文档。