sublime快捷键绑定必须通过args字段显式传参，keys和command本身不支持直接写参数；如show_overlay、run_macro_file等命令缺args将失效或行为异常。
怎么在 keys 和 command 之外传参
Sublime 的快捷键绑定本身不支持直接写参数，必须靠 args 字段显式传递。没加 args，哪怕命令名对了，也大概率不执行或行为异常——比如 show_overlay 不带 {"overlay": "command_palette"} 就只是打开个空面板。
-
args是可选字段，但多数带交互的命令（如打开面板、运行宏、切换布局）都依赖它 - 参数值必须是 JSON 合法类型：字符串、数字、布尔、对象或数组，不能是变量或表达式
- 常见错误是把路径写成相对路径或本地文件路径，实际必须用
res://协议，例如"res://Packages/Default/Delete Line.sublime-macro" - 命令面板入口示例：
{"keys": ["ctrl+alt+p"], "command": "show_overlay", "args": {"overlay": "command_palette"}}
哪些命令必须配 args 才能生效
不是所有命令都需要参数，但以下几类几乎一定需要：
-
run_macro_file：必须带{"file": "..."}，否则静默失败 -
show_overlay：必须指定overlay值为"command_palette"、"goto"或"bookmarks" -
set_layout：必须提供{"cols": [...], "rows": [...], "cells": [...]}完整结构 -
insert_snippet：需传{"contents": "..."}或{"name": "Packages/.../xxx.sublime-snippet"}
查不准时，最稳办法是：按 Ctrl+Shift+P 输入功能关键词（如“goto anything”），看命令面板里显示的完整条目；或开控制台执行 sublime.log_commands(True)，再手动点一次菜单操作，控制台输出里带 args 的那行就是你要抄的。
args 写错的典型现象和排查方式
参数错不会报红字，只会“按了没反应”，这是新手卡住最多的地方。
- 路径拼错、大小写不对、漏掉
res://前缀 → 宏不执行，无提示 -
args键名写错，比如把"overlay"写成"panel"→show_overlay打开空白面板 - 数值类型错：该写数字的地方写了字符串（如
"2"而非2）→ 部分命令拒绝解析 - 用中文标点或末尾多逗号 → 整个
User.sublime-keymap解析失败，右下角弹红字，但只提示“invalid json”，不指明哪一行
建议改完保存后，立刻按快捷键测试；没反应就先看右下角有没有红字，再打开控制台确认是否 log 到命令调用——没 log 就是 JSON 格式或键位冲突问题，log 了但没效果，基本就是 args 错了。
context 和 args 能一起用吗
能，而且很常用。比如你想让 F5 在 Python 文件里运行构建，在 Markdown 里打开浏览器预览，就得靠 context 分流 + 各自配 args：
[{"keys": ["f5"], "command": "build", "args": {"variant": "Run"}, "context": [{"key": "selector", "operator": "equal", "operand": "source.python"}]}, {"keys": ["f5"], "command": "open_url", "args": {"url": "file://${file_path}/${file_base_name}.html"}, "context": [{"key": "selector", "operator": "equal", "operand": "text.html.markdown"}]}]
注意：多个 context 条件是“且”关系；如果想实现“Python 或 JavaScript”，必须拆成两条独立规则，不能在一个对象里写两个 selector。
真正难的不是写 args，而是搞清当前 scope 是什么——按 Ctrl+Shift+P 输入 Show Scope Name，光标所在位置会显示完整语法作用域，这才是 context 里 operand 的真实值。
