使用IMPORTRANGE与MATCH时，getDisplayValue()无法获取显示值

问题描述 #

使用range.getDisplayValues()无法获取单元格已显示的值，操作流程：

• 创建Sheet#1，通过IMPORTRANGE()导入其他电子表格数据；
• 创建Sheet#2，A1单元格使用MATCH("Cell 3", Sheet #1!A:A,0)，屏幕显示值为2；
• 运行脚本获取Sheet#2的显示值时，Logger输出第一个值为空，预期输出应为*:2,Something。

脚本代码：

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet(); //active being #2
var range=sheet.getRange("A1:B1");
var values=range.getDisplayValues();

Logger.log("*:"+values);// Output: *: ,Something

原因 #

核心问题是公式计算与脚本执行不同步：IMPORTRANGE属于跨表异步加载函数，加上MATCH的依赖计算，当脚本执行getDisplayValues()时，单元格的公式可能还未完成计算，导致获取到的是计算前的空值。

解决方案 #

在获取值之前，强制触发电子表格的计算刷新，确保所有公式完成计算后再读取数据：

修改后的脚本：

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getActiveSheet(); //active being #2
// 强制刷新所有公式计算
SpreadsheetApp.flush();
var range=sheet.getRange("A1:B1");
var values=range.getDisplayValues();

Logger.log("*:"+values);// 预期输出: *:2,Something

额外排查点 #

如果上述方法无效，可检查：

• 确认Sheet#1的IMPORTRANGE已完成数据加载，没有显示#REF!或加载提示；
• 确保脚本拥有访问Sheet#1数据的权限（若跨文档，需授权）；
• 尝试将getDisplayValues()替换为getValues()测试，确认是否是显示值的特殊格式问题。

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