ExcelScript 自动化列插入与跨列数据对齐教程-js教程-PHP中文网

ExcelScript 自动化列插入与跨列数据对齐教程

本文介绍如何使用 excelscript 编写可扩展的自动化脚本，动态计算列字母（如从 "dw" → "dx" → "dy"），批量将源数据插入目标列区间，并同步复制标题，高效处理 1500+ 列规模的数据对齐任务。

本文介绍如何使用 excelscript 编写可扩展的自动化脚本，动态计算列字母（如从 "dw" → "dx" → "dy"），批量将源数据插入目标列区间，并同步复制标题，高效处理 1500+ 列规模的数据对齐任务。

在处理大规模横向数据集（如每组含 1500+ 列的双源数据对齐）时，手动拖拽插入不仅低效易错，更难以复现与维护。ExcelScript 提供了基于 TypeScript 的原生自动化能力，但其 getRange() 方法要求显式列名（如 "DW2:DW10"），而列标（如 BHT）随数据增长持续变化——这正是传统硬编码脚本失效的核心原因。本文提供一套健壮、可迭代、支持多字符列名（如 ZZ → AAA） 的解决方案，无需依赖 VBA 或外部工具。

✅ 核心思路：列名递增 + 循环批处理

关键在于将「列名字符串」视为可进位的 26 进制数（A=0, B=1, ..., Z=25），并实现安全的列名自增函数。以下 incrementColumn 函数完整支持单字符（Z→AA）、双字符（AZ→BA）、三字符（BZZ→CAA）甚至更高位列名的自动演进：

// 工具函数：安全递增 Excel 列名（支持任意长度，如 "XFD" → "XFE"）
function incrementColumn(column: string): string {
  const chars = column.toUpperCase().split('');
  let carry = 1;

  // 从右向左逐位处理（类似加法进位）
  for (let i = chars.length - 1; i >= 0 && carry > 0; i--) {
    const code = chars[i].charCodeAt(0) - 64; // A→1, Z→26
    const newCode = code + carry;

    if (newCode  0) {
    chars.unshift('A');
  }

  return chars.join('');
}

? 完整可运行脚本（支持全表批量处理）

以下 main 函数将：

自动识别当前工作表中最后一列（避免硬编码 BHT）；
以固定步长（如每 2 列为一组）循环插入源数据；
动态生成源范围（EC17:EC25）和目标插入范围（DW2:DW10, DX2:DX10, ...）；
同步迁移标题行（第 1 行）并清除冗余内容。

function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const lastColIndex = sheet.getUsedRange().getLastCell().getColumnIndex();
  const lastColumnName = getColumnLetterFromIndex(lastColIndex);

  // 配置参数（按需调整）
  const sourceBaseCol = "EC";     // 源数据所在列（如 EC）
  const sourceRowStart = 17;      // 源数据起始行
  const sourceRowEnd = 25;        // 源数据结束行
  const insertBaseCol = "DW";     // 插入起始列（将在此列及后续列重复插入）
  const insertRows = 9;           // 插入行数（25-17+1）
  const titleRow = 1;             // 标题行号
  const titleSourceCell = `${sourceBaseCol}${titleRow}`; // 如 EC1

  let currentInsertCol = insertBaseCol;
  let processedCount = 0;

  // 主循环：直到插入列超出当前数据边界
  while (getColumnIndexFromLetter(currentInsertCol)  2000) {
      console.warn("Max iteration limit reached. Stopping.");
      break;
    }
  }

  console.log(`✅ Successfully inserted ${processedCount} data blocks.`);
}

? 辅助函数：列名 ↔ 列索引双向转换

ExcelScript 的 getColumnIndex() / getColumnLetter() 并非内置方法，需自行实现：

// 列字母转索引（A→1, Z→26, AA→27, XFD→16384）
function getColumnIndexFromLetter(colLetter: string): number {
  let index = 0;
  const letters = colLetter.toUpperCase().split('');
  for (let i = 0; i  16384) throw new Error("Invalid column index (1–16384)");
  let result = "";
  while (index > 0) {
    index--;
    const remainder = index % 26;
    result = String.fromCharCode(65 + remainder) + result;
    index = Math.floor(index / 26);
  }
  return result;
}