本文介绍如何使用 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 <= 26) {
      chars[i] = String.fromCharCode(newCode + 64);
      carry = 0;
    } else {
      chars[i] = 'A';
      carry = 1;
    }
  }

  // 若最高位仍有进位（如 "ZZ" → "AAA"），在开头补 'A'
  if (carry > 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) <= lastColIndex) {
    const insertStart = `${currentInsertCol}${titleRow + 1}`; // 如 DW2
    const insertEnd = `${currentInsertCol}${titleRow + insertRows}`; // 如 DW10
    const insertRange = `${insertStart}:${insertEnd}`;

    console.log(`Processing insertion at ${insertRange}`);

    // 步骤1：右移插入空白列（为新数据腾出空间）
    sheet.getRange(insertRange).insert(ExcelScript.InsertShiftDirection.right);

    // 步骤2：复制源数据到新位置
    const sourceRange = `${sourceBaseCol}${sourceRowStart}:${sourceBaseCol}${sourceRowEnd}`;
    sheet.getRange(insertRange).copyFrom(sheet.getRange(sourceRange));

    // 步骤3：复制标题（覆盖新插入的两列顶部）
    const titleTargetRange = `${currentInsertCol}${titleRow}:${incrementColumn(currentInsertCol)}${titleRow}`;
    sheet.getRange(titleSourceCell).copyFrom(
      sheet.getRange(titleSourceCell), 
      ExcelScript.RangeCopyType.all, 
      false, 
      false
    );
    // 将标题复制到相邻列（如 DW1 和 DX1）
    sheet.getRange(`${incrementColumn(currentInsertCol)}${titleRow}`).copyFrom(
      sheet.getRange(titleSourceCell),
      ExcelScript.RangeCopyType.all,
      false,
      false
    );

    // 步骤4：更新下一轮插入列（如 DW → DX → DZ → EA...）
    currentInsertCol = incrementColumn(incrementColumn(currentInsertCol)); // 跳过已用列
    processedCount++;

    // 安全防护：防止无限循环（例如列名已达 XFD）
    if (processedCount > 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 < letters.length; i++) {
    const charCode = letters[i].charCodeAt(0) - 64;
    index = index * 26 + charCode;
  }
  return index;
}

// 列索引转字母（1→A, 27→AA, 16384→XFD）
function getColumnLetterFromIndex(index: number): string {
  if (index < 1 || index > 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;
}

⚠️ 注意事项与最佳实践

• 列名上限：Excel 最大列为 XFD（16384），脚本已内置越界防护；
• 性能优化：避免在循环内频繁调用 getRange()；建议批量操作或使用 getUsedRange() 预判范围；
• 标题逻辑：示例中假设标题需跨两列显示（如 "YMEL1,1" & "YMEL1,2"），如需动态生成，请替换 setValues() 语句；
• 错误处理：生产环境建议包裹 try/catch，并在 console.error 中记录失败位置；
• 测试先行：首次运行前，先用小范围（如 DW→DX）验证逻辑，再放开全量。

通过本方案，您不再需要手动拖拽或反复录制宏——只需一次部署，即可应对未来列数增长，真正实现 “写一次，跑千列” 的企业级数据工程自动化。