json_ExtractValue函数

函数名：json_提取值 / json_ExtractValue

函数功能

从JSON字符串中提取指定路径对应的值，适用于结构化数据快速访问与提取。

参数规范

参数名	类型	必填	示例	特殊说明
json	String	是	"{"user":{"name":"张三"}}"	合法JSON格式字符串
path	String	是	"user.name"	使用点分路径表示法，如a.b[0].c

使用案例

基础提取

问题描述：从JSON中提取一级属性的值 公式演示：

=json_ExtractValue("{""name"":""李雷""}", "name")

输出效果：

李雷

多级路径提取

问题描述：从嵌套JSON结构中提取值 公式演示：

=json_ExtractValue("{""user"":{""info"":{""age"":25}}}", "user.info.age")

输出效果：

25

数组内值提取

问题描述：提取JSON数组中的第一个元素 公式演示：

=json_ExtractValue("{""items"":[{""id"":101},{""id"":102}]}", "items[0].id")

输出效果：

101

技术说明

路径语法支持

• 点（.）用于表示属性层级
• 中括号（[n]）用于数组索引访问
• 路径匹配使用JToken.SelectToken()方法，兼容大多数JSON结构

异常处理

错误场景	返回值
非法JSON格式	无效的JSON格式
路径不存在	路径不存在

扩展应用

与单元格结合提取动态数据

=json_ExtractValue(A1, "data.value") // A1中为JSON字符串

表格结构化提取

将多列数据以JSON形式存储后，使用该函数逐列提取并进行统计或对比。

注：本函数已在WPS 2019+ 和 Excel 365 中验证通过，支持多层级嵌套提取与数组访问。