如何用Google Apps Script解析Google Sheets单元格生成CSV文件

遇到的问题 #

• 调用JavaScript内置Array.indexOf方法时，无法定位单元格字符串中实际存在的字符
• 尝试在单元格字符串的字符之间插入下划线时，仅在每个单元格的字符串开头插入了一个下划线

现有测试代码 #

function testCSV() {
  const ss = SpreadsheetApp.getActiveSpreadsheet()
  const sheet = ss.getSheets()[0];
  const range = sheet.getDataRange();
  const values = range.getValues();
  let csvStr = "";
  Logger.log(values);
  for (let i = 0; i < values.length; i++) {
    let row = "";
    for (let j = 0; j < values[i].length; j++) {
      if (values[i][j]) {
        row = row + "_" + values[i][j];
      }
      row = row + ",";
    }
    row = row.substring(0, (row.length-1));
    Logger.log(row);
    csvStr += row + '\n';
  }
}

参考素材 #

• 脚本运行Logger输出：
  
• 测试表格样例：
  

核心需求 #

把单元格内包含逗号的字符串用双引号包裹，生成的文件和标准CSV保存后用文本编辑器打开的展示效果完全一致。

问题根因 #

1. 下划线插入逻辑错误：现有代码是在每个非空单元格整体拼接前加下划线，不是遍历单元格内的单个字符插入，所以只会出现在单元格内容开头，和预期效果不符。
2. indexOf匹配失效通常是两个原因：一是把字符串方法错写成数组方法调用，二是单元格内容存在不可见特殊字符、全角/半角符号混淆，导致匹配目标和实际存储字符不一致。

可直接使用的实现代码 #

以下代码严格遵循RFC 4180 CSV标准，和Google Sheets原生导出CSV的文本格式完全一致：

function exportStandardCSV() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheets()[0];
  const dataRange = sheet.getDataRange();
  const rawValues = dataRange.getValues();
  const csvLineList = [];

  for (const row of rawValues) {
    const processedCellList = row.map(cell => {
      if (cell == null) return '';
      const cellStr = String(cell);
      // 符合CSV转义规则：包含逗号、双引号、换行符的内容必须用双引号包裹，内部双引号转义为两个双引号
      if (cellStr.includes(',') || cellStr.includes('"') || cellStr.includes('\n')) {
        return `"${cellStr.replace(/"/g, '""')}"`;
      }
      return cellStr;
    });
    csvLineList.push(processedCellList.join(','));
  }

  const finalCSVContent = csvLineList.join('\n');
  Logger.log(finalCSVContent);
  // 如需直接生成CSV文件保存到网盘，取消下方注释即可
  // DriveApp.createFile(`${sheet.getName()}.csv`, finalCSVContent, 'text/csv');
  return finalCSVContent;
}

实现说明 #

• 除了逗号场景，同时兼容单元格内存在双引号、手动换行的情况，不会出现CSV列错位问题
• 用数组join方法做拼接，不需要手动处理每行末尾多余的逗号，逻辑更简洁
• 自动兼容数字、日期、布尔类型的单元格值，不会出现类型转换错误

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