库快速入门

构建一个 Apps 脚本库，可用于移除电子表格数据中的重复行。

目标

• 设置脚本。
• 运行脚本。

前提条件

如需使用此示例，您需要满足以下前提条件：

• Google 帐号（Google Workspace 帐号可能需要管理员批准）。
• 能够访问互联网的网络浏览器。

设置脚本

如需构建库，请按以下步骤操作：

1. 登录你的 Google 账号。
2. 如需打开脚本编辑器，请访问 script.google.com。
3. 点击左上角的新建项目。

4. 删除脚本编辑器中的所有代码，然后粘贴以下代码。

   sheets/removingDuplicates/removingDuplicates.gs

   在 GitHub 上查看

   /**
    * Removes duplicate rows from the current sheet.
    */
   function removeDuplicates() {
     const sheet = SpreadsheetApp.getActiveSheet();
     const data = sheet.getDataRange().getValues();
     const uniqueData = {};
     for (let row of data) {
       const key = row.join();
       uniqueData[key] = uniqueData[key] || row;
     }
     sheet.clearContents();
     const newData = Object.values(uniqueData);
     sheet.getRange(1, 1, newData.length, newData[0].length).setValues(newData);
   }

5. 点击“保存”。

6. 点击左上角的未命名项目。

7. 将脚本命名为移除重复行，然后点击重命名。

8. 点击部署 > 新建部署。

9. 点击选择类型旁边的“启用部署类型”图标 > 库。

10. 输入库的说明，例如移除重复行。有权访问该库的任何人都可以查看此说明。

11. 点击部署。

12. 点击左侧的项目设置 。

13. 在 ID 下，复制脚本 ID 以便在后续步骤中使用。

运行脚本

如需使用某个库，您必须至少拥有其 Apps 脚本项目的查看权限。由于您创建了该库，因此具备使用该库所需的权限。如果您希望允许他人使用该库，请授予对方 Apps 脚本项目的查看权限。

如需使用该库，请按以下步骤操作：

1. 打开包含重复行数据的 Google 表格电子表格。要使用电子表格示例，请创建重复行示例电子表格。
2. 点击扩展程序 > Apps 脚本。
3. 点击 Libraries 旁边的 Add a library 。
4. 在脚本 ID 部分中，粘贴您在上一部分中复制的库 Apps 脚本项目中的脚本 ID。
5. 点击查询。
6. 在版本部分，选择 1。
7. 点击添加。

8. 删除脚本编辑器中的所有代码，然后粘贴以下代码。

   function runLibrary() {
    Removeduplicaterows.removeDuplicates();
   }
   

9. 在函数下拉列表中，选择 runLibrary。

10. 点击运行。

11. 返回到电子表格即可查看更新后的数据，而无需重复行。

查看代码

如需查看此解决方案的 Apps 脚本代码，请点击下面的查看源代码：

查看源代码

首先，脚本对电子表格进行单次调用以检索所有数据。您可以选择逐行阅读工作表，但 JavaScript 操作比与其他服务（如电子表格）操作快得多。您发出的调用越少，运行速度就越快。这很重要，因为每次脚本执行的最长运行时间为 6 分钟。

sheets/removingDuplicates/removingDuplicates.gs

在 GitHub 上查看

const sheet = SpreadsheetApp.getActiveSheet();
const data = sheet.getDataRange().getValues();

变量 data 是一个 JavaScript 二维数组，其中包含工作表中的所有值。newData 是一个空数组，脚本会将所有非重复行放入该数组。

sheets/removingDuplicates/removingDuplicates.gs

在 GitHub 上查看

const newData = Object.values(uniqueData);

第一个 for 循环遍历 data 二维数组中的每一行。对于每一行，第二个循环会测试 newData 数组中是否存在具有匹配数据的另一行。如果该行不重复，则会推送到 newData 数组。

sheets/removingDuplicates/removingDuplicates.gs

在 GitHub 上查看

uniqueData[key] = uniqueData[key] || row;

最后，脚本会删除工作表的现有内容，并插入 newData 数组的内容。

sheets/removingDuplicates/removingDuplicates.gs

在 GitHub 上查看

sheet.clearContents();
const newData = Object.values(uniqueData);
sheet.getRange(1, 1, newData.length, newData[0].length).setValues(newData);

修改

您可以根据需要对库进行任意修改，以下是可选修改。

移除某些列中包含匹配数据的行

您可能只想移除其中一列或两列中具有匹配数据的行，而不是移除完全匹配的行。为此，您可以更改条件语句。

在示例代码中，更新以下行：

    if(row.join() == newData[j].join()){
      duplicate = true;
    }

将该行替换为以下代码：

    if(row[0] == newData[j][0] && row[1] == newData[j][1]){
      duplicate = true;
    }

每当工作表的第一列和第二列中的两行数据相同时，上述条件语句就会查找重复项。

贡献者

此示例由 Google 开发者专家 Romain Vialard 创建。在 Twitter @romain_vialard 上关注 Romain。

此示例由 Google 在 Google 开发者专家的帮助下进行维护。

后续步骤

• 库
• 创建和管理部署