JSON 编辑器使用 - 格式与语法要点
为什么用 JSON 格式
Runner 的命令存储不是纯文本 shell 命令,而是 JSON 格式。这样做的好处:
- 支持参数化命令:一个命令模板,多个变量替换
- 支持条件分支:不同场景下自动切换命令行
- 支持批量导入导出:方便在不同设备间同步常用命令集合
- 支持错误检查:编辑器能在执行前做基本的语法校验
JSON 格式结构
一个简单的命令 JSON 对象:
{
"title": "冻结微博",
"command": "pm disable-user --user 0 com.sina.weibo"
}
多个命令组成数组可以批量执行:
[
{"title": "冻结微博", "command": "pm disable-user --user 0 com.sina.weibo"},
{"title": "冻结淘宝", "command": "pm disable-user --user 0 com.taobao.taobao"},
{"title": "冻结抖音", "command": "pm disable-user --user 0 com.ss.android.ugc.aweme"}
]
在 Runner 里打开 JSON 编辑器
不同版本入口略有差异,常见方式:
- 在 Runner 主界面,点击右上角或侧边栏的「编辑」图标(通常是铅笔或代码图标)
- 从历史记录或收藏夹里选择某条命令,长按进入编辑
- 部分版本支持直接导入 JSON 文件
编辑技巧
自动补全:编辑器会根据 shell 语法给出命令建议,比如输入 pm dis 会提示 disable 子命令。
错误检查:保存前编辑器会做 JSON 格式校验。常见的 JSON 语法错误:
- 引号没配对(左引号忘了右引号)
- 逗号写在最后一项后面(JSON 数组最后一项不能 trailing comma)
- 命令里的双引号没有转义(
"hello"在 shell 命令里要写成\"hello\")
多行命令:shell 命令可以用分号分隔多条操作,Runner 会依次执行:
{"command": "echo '开始'; pm disable-user --user 0 com.example.app; echo '完成'"}
或者用换行(部分版本支持):
{"command": "echo '开始'\npm disable-user --user 0 com.example.app\necho '完成'"}
导入导出
导出:在 JSON 编辑器里全选 → 复制,然后粘贴到文件管理器保存为 .json 文件。
导入:在 Runner 的 JSON 编辑器里粘贴完整的 JSON 文本,保存。如果格式正确,命令会被自动解析并加入到槽位或批处理队列。
注意事项
- JSON 里的反斜杠需要转义。比如 shell 里写
\n,JSON 里要写成\\n - 不要在 JSON 里写注释(
//或/* */),标准 JSON 不支持注释 - 命令里的特殊字符(
$、|、&、;、```)会被 shell 原样解析,和你在电脑终端里输入的行为一致