为何filter()方法无法正确隐藏电子表格中不需要的行？

• 公司使用电子表格模板统一管理收到的各类订单，预设操作流程为：选中对应客户、填写各产品需求数量后，点击自定义菜单中的「创建报价单」按钮即可生成对应单据。
• 当前除产品过滤环节外其余功能均运行正常：系统可成功复制生成带唯一引用编码、客户信息准确、命名合规的报价单，但产品过滤逻辑失效，调用filter()方法后既不抛出报错，也未执行预期的过滤动作。
• 故障相关核心代码如下：

// declare that the copy is now the active spreadsheet
    var sheetId = quoteName.getId();
    var openQuoteSheet = SpreadsheetApp.openById(sheetId);
    SpreadsheetApp.setActiveSpreadsheet(openQuoteSheet);  
    SpreadsheetApp.setActiveSheet(openQuoteSheet.getSheets()[0]);
    var allProducts = SpreadsheetApp.getActiveSheet();  

    // filter out the products that the client doesn't need
    var fullSheet = allProducts.getRange('D15:D48').getValues();
    Logger.log(fullSheet);
    fullSheet.filter(checkQuantity);
    openQuoteSheet = SpreadsheetApp.getActiveSpreadsheet();
    filteredProducts = fullSheet.filter(checkQuantity);
    function checkQuantity(amount){ return amount > 0;}
    Logger.log(filteredProducts);

代码存在两个核心问题导致过滤失效：

1. Array.filter()是纯方法，不会修改原数组，执行后会返回全新的过滤后数组。代码中第一次调用fullSheet.filter(checkQuantity)时没有用变量接收返回值，属于无效执行。
2. Google Apps Script中range.getValues()返回的永远是二维数组，即使是单列/单行范围也不例外。读取的D15:D48是单列范围，返回的fullSheet结构为[[单元格D15的值], [单元格D16的值], ...]，传入checkQuantity的amount参数实际是长度为1的子数组，而非单个数值，直接和0做比较时隐式类型转换会导致判断逻辑完全不符合预期。

• 移除无返回值接收的无效filter()调用，所有过滤操作均用变量接收返回的新数组。
• 遍历二维数组时，取每行子数组的第0位（即D列对应行的数量值）做判断，同时增加空值、非数值的兼容判断，避免格式问题导致判断错误。
• 冗余的重复获取活动电子表格的代码可以直接删除，减少不必要的API调用。

修复后可正常运行的代码参考：

// 声明生成的报价单副本为活动电子表格
var sheetId = quoteName.getId();
var openQuoteSheet = SpreadsheetApp.openById(sheetId);
SpreadsheetApp.setActiveSpreadsheet(openQuoteSheet);  
var productSheet = openQuoteSheet.getSheets()[0];
SpreadsheetApp.setActiveSheet(productSheet);

// 读取D列产品数量范围
var quantityRange = productSheet.getRange('D15:D48');
// 拿到的是二维数组，结构为[[D15值], [D16值], ..., [D48值]]
var allQuantity = quantityRange.getValues();
Logger.log("全量数量数据：", allQuantity);

// 执行过滤：判断每行的第0位元素（即D列实际数量）是否为大于0的有效数值
var filteredProducts = allQuantity.filter(row => {
  const currentQty = row[0];
  return typeof currentQty === 'number' && currentQty > 0;
});
Logger.log("过滤后有效产品数量：", filteredProducts);

// 后续如果需要将过滤结果写回表格，直接传入二维结构的filteredProducts调用setValues即可

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