Excel Range 一次性读写到 AHK 数组：二维数组、UsedRange、批量回写

用 AHK 操作 Excel 时，新手很容易一格一格读写：Cells(1,1)、Cells(1,2)、Cells(1,3)。数据少时没问题，数据一多就慢。真正高效的思路，是把一整块 Range 一次性读到 AHK 数组里，处理完再一次性写回。

素材里的群聊记录也提到一个关键坑：Excel 多单元格 Range 的值，在 AHK v1 里通常是二维数组，不适合直接用普通 for k,v 当一维数据遍历。

一、读取一块区域

#Requires AutoHotkey v1.1
#NoEnv
#SingleInstance Force

xl := ComObjActive("Excel.Application")
sheet := xl.ActiveSheet

arr := sheet.Range("A1:C10").Value
MsgBox, % "第 2 行第 3 列：" arr[2, 3]

这里的 arr[2,3] 对应 Excel 区域里的第 2 行第 3 列，不是工作表绝对坐标。也就是说，如果你读的是 D5:F10，arr[1,1] 对应的是 D5。

二、遍历二维数组

多单元格 Range 返回二维数组时，可以用 MaxIndex(1) 取行数，用 MaxIndex(2) 取列数。

rows := arr.MaxIndex(1)
cols := arr.MaxIndex(2)

Loop, %rows%
{
    r := A_Index
    Loop, %cols%
    {
        c := A_Index
        value := arr[r, c]
        ; 在这里处理 value
    }
}

这比逐格调用 COM 快得多，因为 COM 跨进程调用本身有开销。一次读进来，在 AHK 内部循环处理，最后一次写回，是 Excel 自动化里非常重要的性能习惯。

三、修改后批量写回

读出来的数组可以直接改值，然后赋回同样大小的 Range。

arr := sheet.Range("A1:B5").Value

Loop, % arr.MaxIndex(1)
{
    arr[A_Index, 2] := "已处理"
}

sheet.Range("A1:B5").Value := arr

注意：写回区域的大小要和数组大小匹配。你读了 5 行 2 列，就应该写回 5 行 2 列。

四、UsedRange 适合整表处理

如果不知道实际数据范围，可以先用 UsedRange。它适合处理“当前工作表中已经使用过的区域”。

used := sheet.UsedRange
arr := used.Value

MsgBox, % "行数：" arr.MaxIndex(1) "，列数：" arr.MaxIndex(2)

UsedRange 有时会包含曾经用过但后来清空的区域，遇到范围异常时，可以先保存文件、清理空行空列，或者用最后单元格查找法重新确定范围。

五、FormulaR1C1 和 Value 的区别

Value 读写的是单元格结果值，FormulaR1C1 可以读写公式。素材里的例子用 FormulaR1C1 批量写公式和字符串，这个在生成报表时很常用。

arr := sheet.Range("A1:B2").FormulaR1C1
arr[1, 1] := "=1+1"
arr[2, 1] := "字符串"
sheet.Range("A1:B2").FormulaR1C1 := arr

结语

Excel COM 的性能关键，不是把循环写得多漂亮，而是减少逐格 COM 调用。能一次读 Range，就不要一格一格读；能一次写回，就不要一格一格写。理解二维数组以后，AHK 处理 Excel 大量数据会顺手很多。