如何让Google Sheets导出的CSV文件支持用户自定义文件名？

架构老林

2026-5-21

实现Google Sheets自定义CSV下载文件名的方案

当然可以搞定自定义下载文件名的需求！这里有两种实用的方法，你可以根据自己的使用场景来选：

方法1：通过Web App返回带自定义文件名的CSV

如果你的需求是通过Web链接让用户下载，最靠谱的方式是把脚本部署为Web App，直接在响应里设置文件名。这样用户访问链接时，浏览器会自动用你指定的名字保存文件。

代码示例：

function doGet(e) {
  // 定位到目标工作表
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('SheetName');
  
  // 把工作表数据转换成CSV格式（处理引号转义，避免CSV格式错误）
  const csvContent = targetSheet.getDataRange().getValues()
    .map(row => row.map(cell => `"${cell.toString().replace(/"/g, '""')}"`).join(','))
    .join('\n');
  
  // 支持通过URL参数自定义文件名，比如访问链接时加 ?filename=我的数据.csv
  const customFileName = e.parameter.filename || '默认文件名.csv';
  
  // 创建CSV响应并设置下载文件名
  const output = ContentService.createTextOutput(csvContent);
  output.setMimeType(ContentService.MimeType.CSV);
  output.downloadAsFile(customFileName);
  
  return output;
}

部署Web App后，用户访问链接时可以通过?filename=xxx.csv参数指定文件名，也可以在代码里固定一个默认名称，非常灵活。

方法2：用HTML的download属性强制指定文件名

如果是在Google Sheets内部通过自定义菜单/侧边栏触发下载，可以借助HTML的download属性来覆盖默认文件名。

步骤如下：

在脚本编辑器里新建一个HTML文件（命名为download.html）：

<!DOCTYPE html>
<html>
  <body>
    <div style="padding: 1rem;">
      <input type="text" id="fileNameInput" placeholder="输入文件名（带.csv）" value="我的数据.csv">
      <button onclick="startDownload()">下载CSV</button>
    </div>
    <script>
      // 从脚本获取CSV的原始下载链接
      const csvUrl = '<?= csvUrl ?>';
      
      function startDownload() {
        const fileName = document.getElementById('fileNameInput').value || '默认文件名.csv';
        // 创建临时链接触发下载
        const tempLink = document.createElement('a');
        tempLink.href = csvUrl;
        tempLink.download = fileName;
        document.body.appendChild(tempLink);
        tempLink.click();
        document.body.removeChild(tempLink);
        google.script.host.close();
      }
    </script>
  </body>
</html>

在GS脚本里添加触发逻辑：

function showCustomDownloadDialog() {
  // 生成原始的CSV下载链接
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheetId = ss.getSheetByName('SheetName').getSheetId();
  const csvUrl = `https://spreadsheets.google.com/feeds/download/spreadsheets/Export?key=${ss.getId()}&gid=${sheetId}&exportFormat=csv`;
  
  // 加载HTML模板并传递链接
  const htmlTemplate = HtmlService.createTemplateFromFile('download.html');
  htmlTemplate.csvUrl = csvUrl;
  
  // 弹出下载对话框
  SpreadsheetApp.getUi().showModalDialog(
    htmlTemplate.evaluate().setWidth(350).setHeight(120),
    '自定义CSV下载'
  );
}

// 给表格添加自定义菜单，方便用户触发
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('我的工具')
    .addItem('下载自定义命名的CSV', 'showCustomDownloadDialog')
    .addToUi();
}

这个方法会弹出一个对话框，让用户输入想要的文件名，点击下载后就会用输入的名称保存CSV，体验非常友好。

注意事项

两种方法都需要确保用户有目标表格的访问权限，否则会跳转到登录页面；
Web App部署时，权限设置要根据需求选择（如果需要公开访问，选“任何人，甚至匿名”）；
CSV格式转换时要注意处理带引号的单元格，避免导出的CSV出现格式错误。

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

如何让Google Sheets导出的CSV文件支持用户自定义文件名？

方法1：通过Web App返回带自定义文件名的CSV #

方法2：用HTML的download属性强制指定文件名 #

注意事项 #

方法1：通过Web App返回带自定义文件名的CSV

方法2：用HTML的download属性强制指定文件名

注意事项