跳至内容

命令

命令在 Sublime Text 中无处不在:键绑定、菜单项和宏都通过命令系统工作。它们也存在于其他地方。

一些命令是在编辑器的核心代码中实现的,但其中许多是作为 Python 插件提供的。每个命令都可以从 Python 插件调用。

命令调度

通常,命令绑定到应用程序对象、窗口对象或视图对象。但是,窗口对象将根据输入焦点调度命令,因此您可以从窗口对象发出视图命令,并且会为您找到正确的视图实例。

命令的结构

命令有一个用下划线分隔的名称(蛇形命名法),例如 hot_exit,并且可以接受一个参数字典,其键必须是字符串,其值必须是 JSON 类型。以下是一些从 Python 控制台运行的命令示例

py
view.run_command("goto_line", {"line": 10})
view.run_command('insert_snippet', {"contents": "<$SELECTION>"})
view.window().run_command("prompt_select_project")

从命令行 (CLI)

命令可以直接从操作系统的命令行传递给 Sublime Text。用法

bash
subl --command 'show_overlay {"overlay": "command_palette", "text": "hello"}'
# on Windows:
sublime-text.exe --command "show_overlay {\"overlay\": \"command_palette\", \"text\": \"hello\"}"

另请参阅

命令参考