如何使用Excel JavaScript API开发Excel插件时实现跨工作表复制列

你可以通过 Range.copyFrom() 方法直接实现跨工作表的单元格或指定区域复制，该方法支持传入不同工作表的源区域对象，无需额外做数据中转。

完整代码示例 #

以下示例实现将Sheet1的A1:A10区域复制到Sheet2从B1开始的位置：

await Excel.run(async (context) => {
  // 获取源、目标工作表实例
  const sourceWorksheet = context.workbook.worksheets.getItem("Sheet1");
  const targetWorksheet = context.workbook.worksheets.getItem("Sheet2");

  // 定义源区域和目标粘贴起始位置
  const copySource = sourceWorksheet.getRange("A1:A10");
  const pasteTarget = targetWorksheet.getRange("B1");

  // 执行复制，默认复制全部内容（值、格式、公式等）
  pasteTarget.copyFrom(copySource);

  await context.sync();
});

自定义复制规则 #

你可以通过调整copyFrom的入参控制复制行为，示例如下：

// 仅复制源区域的值，跳过格式、公式，不跳过空单元格、不转置
pasteTarget.copyFrom(copySource, Excel.RangeCopyType.values, false, false);

参数说明：

• 第二个参数为复制类型，可选值包括：
  • Excel.RangeCopyType.all：默认值，复制源区域的全部内容
  • Excel.RangeCopyType.values：仅复制单元格数值
  • Excel.RangeCopyType.formats：仅复制单元格格式
  • Excel.RangeCopyType.formulas：仅复制单元格公式
• 第三个布尔参数：是否跳过空单元格复制，填true时源区域的空单元格不会覆盖目标区域已有内容
• 第四个布尔参数：是否转置粘贴，填true时会将源区域行列互换后粘贴

常见场景补充 #

如果需要复制整列，直接将源区域定义为整列即可，比如sourceWorksheet.getRange("A:A")，目标区域仅需指定起始单元格，API会自动匹配源区域的尺寸完成粘贴，无需手动计算目标区域的大小。

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