JSON

按名称删除 JSON 节点

删除指定 JSON 当前层中的目标名称节点,适用于移除对象字段、撤销标记和清理局部配置项。

命令用途

Json-DeleteByName 对应的实际命令写法是 JSON <标识> DeleteByName,用于按名称删除当前层中的 JSON 节点。

它适合删除对象当前层里的某个字段,不需要继续写完整路径时用起来更直接。

命令名

Json-DeleteByName

调用格式

JSON <标识> DeleteByName <名称>

参数说明

参数必填说明
标识是要处理的 JSON 标识。
DeleteByName是固定子命令,表示按名称删除当前层节点。
名称是要删除的字段名称。

返回或影响

  • 该命令会从当前层中删除指定名称的节点。
  • 删除后,这个名称对应的值将不再能通过原路径读取。
  • 这条命令更适合处理对象当前层字段,不负责跨层路径删除。

示例

基础用法

#ACT
JSON 奖励配置 DeleteByName rewardName

这段写法会从 奖励配置 当前层删除 rewardName 这个字段。

常见变体

#IF
CheckJson 奖励配置 N expired 0
#ACT
JSON 奖励配置 DeleteByName expired

这类写法适合先确认目标字段存在,再把当前层中的过期标记删掉。

注意事项

  • Json-DeleteByName 只删除当前层名称,不适合直接删除深层路径。
  • 如果目标节点位于对象内部更深的位置,应改用 Json-DeleteByPath。
  • 删除前如果需要先确认字段是否存在,通常可先配合 CheckJson 的 N 判断。

相关命令