为何注释Excel Script中的console.log会改变代码功能？

问题场景 #

在Excel Script中实现数据校验逻辑：读取数据表（DataTable）与查找表（LookupTable），验证数据表的所有类别都存在于查找表中。核心逻辑是先提取数据表的唯一类别，再用every函数逐一校验，若发现不存在的类别则记录错误并终止流程。

实际运行出现异常：保留代码中的console.log(e)时，能正确检测到不存在的类别（如类别C），记录错误并终止流程；但注释该log语句后，代码会直接跳过验证执行后续逻辑，最终触发报错。即使将log放在every内部的if判断外，也能让校验正常工作。

原因分析 #

这是因为Excel Script中读取单元格/表数据的API（如getValues()）本质是异步操作，如果代码未正确等待异步操作完成就执行后续的every校验，此时数据还未完全加载，uniqueCategories可能为空数组或数据不完整，导致every直接返回true，跳过验证逻辑。而console.log是同步操作，会阻塞主线程，给异步读取数据的操作留出完成时间，因此添加log时校验能正常执行。

解决方案 #

确保所有读取Excel数据的操作都通过await等待异步任务完成，保证数据完全加载后再执行校验逻辑。

错误代码示例（未处理异步） #

function main(workbook: ExcelScript.Workbook) {
  // 获取数据表和查找表
  const dataTable = workbook.getTable("DataTable");
  const lookupTable = workbook.getTable("LookupTable");

  // 提取数据表的类别列（假设是第2列）
  const dataCategories = dataTable.getColumnByName("类别").getRange().getValues();
  // 提取唯一类别
  const uniqueCategories = [...new Set(dataCategories.flat())];

  // 提取查找表的类别列表
  const lookupCategories = lookupTable.getColumnByName("允许类别").getRange().getValues().flat();

  // 校验所有类别都在查找表中
  const allValid = uniqueCategories.every(e => {
    const exists = lookupCategories.includes(e);
    if (!exists) {
      console.log(`错误：类别${e}不存在于查找表中`);
      // console.log(e); // 注释掉该语句后校验失效
    }
    return exists;
  });

  if (!allValid) {
    console.log("校验不通过，终止流程");
    return;
  }

  // 后续处理逻辑
  console.log("校验通过，执行后续操作");
}

修正后的代码（处理异步操作） #

async function main(workbook: ExcelScript.Workbook) { // 改为async函数
  // 获取数据表和查找表
  const dataTable = workbook.getTable("DataTable");
  const lookupTable = workbook.getTable("LookupTable");

  // 提取数据表的类别列，await等待异步操作完成
  const dataCategoriesResult = await dataTable.getColumnByName("类别").getRange().getValuesAsync();
  const dataCategories = dataCategoriesResult.value;
  // 提取唯一类别
  const uniqueCategories = [...new Set(dataCategories.flat())];

  // 提取查找表的类别列表，await等待异步操作完成
  const lookupCategoriesResult = await lookupTable.getColumnByName("允许类别").getRange().getValuesAsync();
  const lookupCategories = lookupCategoriesResult.value.flat();

  // 校验所有类别都在查找表中
  const allValid = uniqueCategories.every(e => {
    const exists = lookupCategories.includes(e);
    if (!exists) {
      console.log(`错误：类别${e}不存在于查找表中`);
    }
    return exists;
  });

  if (!allValid) {
    console.log("校验不通过，终止流程");
    return;
  }

  // 后续处理逻辑
  console.log("校验通过，执行后续操作");
}

关键修正点 #

1. 将main函数改为async，支持使用await等待异步任务
2. 使用getValuesAsync()替代同步的getValues()，通过await等待数据读取完成，再通过.value获取实际的单元格值数组
3. 确保执行every校验前，所有数据已从Excel加载完成，避免因数据未就绪导致的校验失效

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