Google Apps Script与Sheets中按名称查询JSON导入数据的问题

嘿，我完全懂你现在的困惑——之前我用Apps Script处理复杂JSON的时候，也卡在过按特定字段匹配的环节，给你分享几个实用的步骤，应该能帮你快速突破瓶颈！

第一步：先明确你的JSON结构（关键前提） #

首先得搞清楚你的JSON是啥样的，我先拿最常见的数组结构举例子（如果你的结构是嵌套的，后面会说调整方法）：

[
  {"name": "Alice", "email": "alice@example.com", "age": 30},
  {"name": "Bob", "email": "bob@example.com", "age": 25},
  {"name": "Charlie", "email": "charlie@example.com", "age": 35}
]

第二步：编写核心的JSON解析+匹配函数 #

先写一个能获取JSON数据，再按name匹配的函数。分两种情况：

情况1：JSON来自外部URL #

如果你的JSON是存在线上的（比如API接口、云存储链接），用UrlFetchApp获取：

// 先获取JSON数据
function fetchJSONData() {
  const jsonUrl = "你的JSON文件在线链接";
  try {
    const response = UrlFetchApp.fetch(jsonUrl);
    return JSON.parse(response.getContentText());
  } catch (error) {
    console.log("获取JSON出错：", error);
    return [];
  }
}

// 根据name匹配提取信息
function getInfoByName(targetName) {
  const jsonData = fetchJSONData();
  // 精准匹配name字段
  const matchedItem = jsonData.find(item => item.name === targetName);
  
  if (matchedItem) {
    // 返回你需要的字段，这里返回email和age，可按需修改
    return {
      email: matchedItem.email,
      age: matchedItem.age
    };
  } else {
    return "未找到匹配的名称";
  }
}

情况2：JSON存在Google Sheets单元格里 #

如果你的JSON字符串直接存在Sheets的某个单元格（比如A1），就改成从单元格读取：

// 从Sheets单元格读取JSON
function getJSONFromSheet() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  const jsonString = sheet.getRange("A1").getValue();
  try {
    return JSON.parse(jsonString);
  } catch (error) {
    console.log("解析JSON出错：", error);
    return [];
  }
}

// 同样的匹配函数，只是数据源换了
function getInfoByName(targetName) {
  const jsonData = getJSONFromSheet();
  const matchedItem = jsonData.find(item => item.name === targetName);
  
  if (matchedItem) {
    return {
      email: matchedItem.email,
      age: matchedItem.age
    };
  } else {
    return "未找到匹配的名称";
  }
}

第三步：和Sheets单元格联动，实现输入即查询 #

写一个自定义函数，这样你在单元格里输入名称，就能自动返回对应信息：

// 自定义函数，直接在Sheets里调用：=GETINFOBYNAME(B1)
// 其中B1是你输入目标名称的单元格
function GETINFOBYNAME(targetName) {
  if (!targetName) return "请输入查询名称";
  
  const result = getInfoByName(targetName);
  if (typeof result === "string") {
    return result; // 返回错误提示
  } else {
    // 返回多个字段，会自动填充到当前单元格右侧的单元格
    return [result.email, result.age];
    // 如果只需要单个字段，比如只返回email，就改成：return result.email;
  }
}

关键调整技巧（适配不同JSON结构） #

• 如果你的JSON是嵌套结构（比如{"data": [{"name": "..."}]}），只需要把jsonData.find(...)改成jsonData.data.find(...)
• 如果需要忽略大小写匹配，把判断条件改成：item.name.toLowerCase() === targetName.toLowerCase()
• 如果有多个重名的条目，把find换成filter，返回所有匹配的数组，比如：const matchedItems = jsonData.filter(item => item.name === targetName);，然后在Sheets里展开显示

测试方法 #

1. 打开你的Google Sheets，点击「扩展程序」→「Apps Script」
2. 把上面的代码粘贴进去，保存并授权权限
3. 在Sheets里输入一个已知的name（比如B1单元格输入"Alice"）
4. 在C1单元格输入=GETINFOBYNAME(B1)，就能看到对应的email和age自动填充到C1、D1单元格啦！

内容的提问来源于stack exchange，提问作者Mikelong1994