如何用Google App Script设置文档表格单元格虚线边框？

阿华AIGC实验室

2026-5-25

在Google Apps Script中给Google Docs表格设置虚线边框

嘿，我之前也在Google Docs脚本里卡过这个虚线边框的问题！其实解决方案是有的，只是它的位置有点隐蔽——不在普通的Attributes或者Table/TableCell的基础方法里，而是藏在TableCellBorder这个类的构建器中。

核心思路

Google Apps Script提供了DocumentApp.newTableCellBorder()构建器，专门用来定义单元格边框的样式，其中就包含了设置虚线样式的setDashStyle()方法，支持多种非实线的边框样式。

具体步骤与代码示例

获取目标表格/单元格
先定位到你需要修改的表格，比如获取文档中的第一个表格：
```
const doc = DocumentApp.getActiveDocument();
const table = doc.getBody().getTables()[0];
```
创建虚线边框样式
使用TableCellBorder构建器定义你想要的虚线样式，包括颜色、宽度和虚线类型：
```
// 定义短虚线边框
const dashedBorder = DocumentApp.newTableCellBorder()
  .setColor('#000000') // 设置边框颜色
  .setWidth(1) // 设置边框宽度（单位：点）
  .setDashStyle(DocumentApp.BorderDashStyle.DASH) // 设置为短虚线
  .build();
```
可用的虚线样式枚举值有：
- DocumentApp.BorderDashStyle.SOLID：实线（默认）
- DocumentApp.BorderDashStyle.DASH：短虚线
- DocumentApp.BorderDashStyle.DASH_DOT：点划线（短虚线段+点交替）
- DocumentApp.BorderDashStyle.DASH_DOT_DOT：双点划线（短虚线段+两个点交替）

给单元格应用边框
你可以给单个单元格的所有边框设置样式，或者单独设置某一边（比如上、下、左、右）：

// 给指定单元格的所有边框应用虚线样式
table.getCell(0, 0).setBorder(dashedBorder);

// 仅给单元格的底部边框设置虚线样式
table.getCell(0, 1).setBottomBorder(dashedBorder);

完整示例代码

下面是一个创建表格并给所有单元格设置虚线边框的完整脚本：

function createTableWithDashedBorders() {
  const doc = DocumentApp.getActiveDocument();
  const body = doc.getBody();

  // 添加一个3x3的表格
  const tableData = [
    ['姓名', '年龄', '职业'],
    ['张三', '28', '工程师'],
    ['李四', '32', '设计师']
  ];
  const table = body.appendTable(tableData);

  // 定义虚线边框样式
  const dashedBorder = DocumentApp.newTableCellBorder()
    .setColor('#666666')
    .setWidth(1)
    .setDashStyle(DocumentApp.BorderDashStyle.DASH_DOT) // 使用点划线
    .build();

  // 遍历所有单元格，应用边框样式
  for (let rowIndex = 0; rowIndex < table.getNumRows(); rowIndex++) {
    const row = table.getRow(rowIndex);
    for (let cellIndex = 0; cellIndex < row.getNumCells(); cellIndex++) {
      const cell = row.getCell(cellIndex);
      cell.setBorder(dashedBorder);
    }
  }

  doc.saveAndClose();
}