如何在从Firestore拉取数据至Google表格时按指定顺序或字母顺序排列列

我完全懂你遇到的困扰——每次运行导入函数，表格列的顺序都乱跳，这确实很影响使用体验。问题出在原代码里获取列名的方式：Object.keys(first)返回的对象键顺序在早期JavaScript环境里并不保证稳定，再加上Firestore返回的文档字段本身没有固定顺序，就导致了列顺序随机的情况。

下面给你两种实用的解决方案，你可以根据需求选择：

方案1：指定固定的列顺序（推荐有明确需求时使用） #

如果你希望列严格按照自己想要的逻辑排列，直接定义一个包含字段名的数组就行，不用依赖Object.keys的返回结果。这样不管Firestore返回的字段顺序如何，表格里的列都会保持一致。

修改后的代码示例：

function importData() { 
  const firestore = getFirestore(); 
  const allDocuments = firestore.getDocuments('Data').map(function(document) { 
    return document.fields; 
  }); 

  // 替换成你需要的固定列顺序，字段名要和Firestore里的完全一致（大小写敏感）
  const fixedColumns = ['userName', 'email', 'registrationDate', 'status']; 

  // 可选：如果要确保包含所有文档里的字段（包括固定列表里没写的），可以用这段代码
  // const allExistingFields = [...new Set(allDocuments.flatMap(doc => Object.keys(doc)))];
  // const columns = [...fixedColumns, ...allExistingFields.filter(field => !fixedColumns.includes(field))];

  const sheet = SpreadsheetApp.getActiveSpreadsheet(); 
  const ss = sheet.getActiveSheet(); 
  ss.clear(); 
  sheet.appendRow(fixedColumns); 
  allDocuments.forEach(function(document) { 
    const row = fixedColumns.map(function(column) { 
      // 如果某个文档没有该字段，返回空字符串避免出现undefined
      return document[column] || ''; 
    }); 
    sheet.appendRow(row); 
  }); 
  trimData(); 
  formatData(); 
}

方案2：按字母顺序排列列 #

如果没有特定的顺序要求，只是希望列顺序保持一致，那就对获取到的字段名进行排序。这样每次导入的列都会按字母顺序排列，不会再随机变动。

修改后的代码示例：

function importData() { 
  const firestore = getFirestore(); 
  const allDocuments = firestore.getDocuments('Data').map(function(document) { 
    return document.fields; 
  }); 

  // 收集所有文档的字段名，去重后按字母排序
  const allFields = [...new Set(allDocuments.flatMap(doc => Object.keys(doc)))];
  const sortedColumns = allFields.sort();

  const sheet = SpreadsheetApp.getActiveSpreadsheet(); 
  const ss = sheet.getActiveSheet(); 
  ss.clear(); 
  sheet.appendRow(sortedColumns); 
  allDocuments.forEach(function(document) { 
    const row = sortedColumns.map(function(column) { 
      return document[column] || ''; 
    }); 
    sheet.appendRow(row); 
  }); 
  trimData(); 
  formatData(); 
}

注意事项 #

• Firestore的字段名是大小写敏感的，所以固定列列表里的字段名要和数据库里的完全匹配；
• 用|| ''处理缺失字段是为了避免表格里出现undefined，你也可以根据需要改成null或者其他默认值；
• 如果你的文档字段可能随时新增，方案2的“收集所有字段再排序”会自动把新字段加到表格里，不用手动修改代码。

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