Excel Script开发需求：遍历指定列查找黄色单元格并插入新行

原代码存在的问题 #

• 变量重复定义：外层let i = "F1"和循环内let i = 0冲突，导致遍历逻辑混乱
• 错误使用getActiveCell()：该方法仅获取当前手动选中的单元格，无法实现遍历指定列的需求
• 列索引错误：getColumn(6)对应第7列（G列），若目标是F列应使用getColumn(5)（Excel Script中列索引从0开始）
• 条件判断错误：if (g = "#FFFF00")使用赋值运算符=而非比较运算符===，导致逻辑永远为真
• 插入行逻辑冗余且易出错：通过地址截取行号的方式不够可靠，且未考虑插入行后对后续遍历的影响（从上往下遍历会跳过新插入行下方的原行）

修正后的代码 #

function main(workbook: ExcelScript.Workbook) {
    // 获取当前活动工作表
    const sheet = workbook.getActiveWorksheet();
    // 获取工作表的已使用区域
    const usedRange = sheet.getUsedRange();
    if (!usedRange) return; // 处理空表情况
    
    // 指定目标列：F列（索引为5，因为Excel Script列索引从0开始）
    const targetColumn = usedRange.getColumn(5);
    const rowCount = targetColumn.getRowCount();

    // 从下往上遍历，避免插入行后漏处理原行
    for (let i = rowCount - 1; i >= 0; i--) {
        const currentCell = targetColumn.getRow(i).getCell(0, 0);
        const fillColor = currentCell.getFormat().getFill().getColor();
        
        // 判断单元格填充色是否为黄色（#FFFF00）
        if (fillColor === "#FFFF00") {
            // 获取当前单元格所在的行，在其下方插入一行
            currentCell.getEntireRow().getOffsetRange(1, 0).insert(ExcelScript.InsertShiftDirection.down);
        }
    }
}

代码说明 #

• 从下往上遍历：插入行后，原行下方的行会被下移，从末尾开始遍历不会导致后续行的索引偏移，确保所有目标单元格都被检查
• 直接操作行对象：通过getEntireRow()获取完整行，再用getOffsetRange(1,0)定位到下方行，插入逻辑更直观可靠
• 增加空表判断：避免工作表无数据时出现错误
• 明确目标列：通过索引5指定F列，符合Excel Script的索引规则

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