JSON
按路径设置 JSON 值
按路径写入或覆盖 JSON 中的目标值，适用于修改深层字段、数组成员赋值和按层级更新结构化数据。
命令用途
Json-SetValueByPath 对应的实际命令写法是 JSON <标识> SetValueByPath，用于按路径写入或覆盖 JSON 中的目标值。
它适合直接修改对象内部深层字段、数组成员或多层路径下的具体值，不需要先逐层拆开再回写。
命令名
Json-SetValueByPath
调用格式
JSON <标识> SetValueByPath <路径> <值>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要写入的 JSON 标识。 |
SetValueByPath | 是 | 固定子命令，表示按路径写值。 |
路径 | 是 | 要设置的目标路径，可继续写对象层级或数组索引。 |
值 | 是 | 要写入的新值，支持字符串、整数、浮点数、数组、对象和日期文本。 |
返回或影响
- 该命令会把目标路径上的值写成新的内容。
- 适合更新深层对象字段或数组中的单个成员。
- 这条命令是路径写值，不限于当前层字段操作。
示例
基础用法
#ACT
JSON myjson SetValueByPath 日期 "2018-11-12 06:12:11"
这段写法会把 myjson 中 日期 路径设置成指定的日期字符串。
常见变体
#ACT
JSON myjson SetValueByPath 数组 ["字符串",100,null,true,false,123.4]
JSON myjson SetValueByPath 对象 {"name":"Object_Name","value":"Object_Value"}
这类写法适合直接把某个路径替换成数组或对象。
注意事项
- 路径写错层级时，脚本会直接改错位置或达不到预期结果。
- 值本身如果包含空格、日期文本或完整对象字符串，建议用双引号或合法 JSON 文本写法保持完整。
- 如果你只是修改当前层里的单个字段，不需要路径能力时，
Json-AddOrUpdateValue会更直接。