求助：Sheets.Spreadsheets.Values.update设USER_ENTERED后单元格全空白

你遇到的USER_ENTERED模式下填充空白的问题，大概率是以下几个原因导致的，逐一排查即可：

1. ValueRange 结构错误 #

Sheets API 的Values.update要求传入的valueRange必须是包含values字段的对象，格式如下：

const valueRange = {
  values: 你的处理后数据数组
};

如果你的valueRange没有正确设置values属性，或者该属性对应的数组为空/未定义，API 执行时不会报错，但会将目标范围填充为空白。先检查你的valueRange结构是否符合要求，打印console.log(valueRange.values)确认数据存在且格式正确。

2. 数据格式不兼容USER_ENTERED模式 #

USER_ENTERED是模拟用户手动输入数据，Sheets 会按照输入规则解析内容，和RAW模式直接写入原始值完全不同：

• 如果你传入的是日期序列号（比如 Excel/Sheets 中日期对应的数字），USER_ENTERED无法识别，会转为空白；需要改成 Sheets 能识别的日期字符串，比如"2024-05-20"或"2024/05/20"。
• 货币值如果是纯数字（比如100.5），USER_ENTERED只会识别为普通数字，若要被识别为货币，需要写成带符号的字符串，比如"$100.50"。
• 数据中如果存在null或undefined，USER_ENTERED会直接解析为空单元格，而RAW模式会保留这些空值标记。

3. 目标范围与数据尺寸不匹配 #

如果你的目标范围只写了工作表名（比如"Sheet Name"），API 默认会覆盖整个工作表的所有单元格。如果你的处理后数据行数/列数远小于工作表现有范围，超出数据部分的单元格会被清空，看起来像是整个工作表被空白填充。解决方法是指定精确的目标范围，比如"Sheet Name!A1:D100"，确保范围尺寸和你的数据数组的行列数一致。

快速调试方法 #

先用小批量测试数据验证USER_ENTERED模式是否正常工作：

// 测试用数据
const testValueRange = {
  values: [["测试文本", 123, "$45.67", "2024/05/20"]]
};
// 指定精确范围
const result = Sheets.Spreadsheets.Values.update(
  testValueRange, 
  ss.getId(), 
  "Sheet Name!A1:D1", 
  {valueInputOption: 'USER_ENTERED'}
);

如果测试数据能正常写入，说明问题出在你的处理后数据格式上；如果还是空白，再检查valueRange的结构和权限配置（不过你说无报错，权限大概率没问题）。

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