文档 自定义命令

在阅读本节之前,请查看 命令面板 文档,了解如何向命令面板添加自定义条目。

Sublime Merge 旨在可自定义。您可以轻松地将自己的自定义 Git 命令添加到菜单中,并使用自定义选择器创建更复杂的命令。

基本示例

以下是一个运行 git rebase -i master 的基本自定义 git 命令的示例。

{
    "caption": "Interactive rebase onto master",
    "command": "git",
    "args": {"argv": ["rebase", "-i", "master"]}
}

您可以看到参数在 "argv" 数组中指定,每个参数之间用逗号分隔。

使用选择器

上面示例的局限性在于 master 是硬编码的。如果我们想选择一个分支来进行 rebase 呢?

这就是选择器派上用场的地方。选择器允许我们在运行时选择一个引用,而不是硬编码一个值。

可用选择器

Sublime Merge 支持以下选择器,这些选择器可与 git 命令一起使用

$select_branch
允许用户选择一个分支(本地或远程)
$select_local_branch
允许用户选择一个本地分支
$select_remote_branch
允许用户选择一个远程分支
$select_commit
允许用户选择一个提交(以提交哈希的形式)
$select_tag
允许用户选择一个标签
$select_stash
允许用户选择一个 stash(以 stash 索引的形式)
$text
允许用户提供任意文本

如果我们想更新前面的示例,可以执行以下操作

{
    "caption": "Interactive rebase…",
    "command": "git",
    "args": {"argv": ["rebase", "-i", "$select_branch"]}
}

现在,系统将提示用户选择一个分支来进行 rebase。