PowerShell遍历已打开Excel的A列匹配值并读取整行数据

以下是针对需求的完整PowerShell脚本，基于你已有的Excel实例连接代码，实现A列匹配与整行数据读取：

# 已有的Excel实例与工作表获取代码
$objExcel = [Runtime.Interopservices.Marshal]::GetActiveObject('Excel.Application')
$objExcel.Visible = $True
$xlSrc = "你的文件路径" # 替换为实际文件路径
$strSheetName = "目标工作表名" # 替换为实际工作表名
$WorkBook = $objExcel.Workbooks.Open($xlSrc)
$worksheet = $WorkBook.sheets.Item($strSheetName)

# ------------------- 核心逻辑 -------------------
# 1. 定义要匹配的目标值
$targetValue = "需要匹配的内容" # 替换为你的预设变量

# 2. 获取A列最后一个有数据的行号（避免遍历空行）
$lastRow = $worksheet.Cells($worksheet.Rows.Count, 1).End([Excel.XlDirection]::xlUp).Row

# 3. 遍历A列每一行
for ($row = 1; $row -le $lastRow; $row++) {
    $currentValue = $worksheet.Cells($row, 1).Value2

    # 跳过空单元格，避免匹配错误
    if (-not $currentValue) { continue }

    # 检查是否匹配目标值
    if ($currentValue -eq $targetValue) {
        Write-Host "找到匹配行：第 $row 行"

        # 4. 获取该行最后一个有数据的列号
        $lastColumn = $worksheet.Cells($row, $worksheet.Columns.Count).End([Excel.XlDirection]::xlToLeft).Column

        # 方式一：用数组存储整行值（按列顺序）
        $rowValuesArray = @()
        for ($col = 1; $col -le $lastColumn; $col++) {
            $rowValuesArray += $worksheet.Cells($row, $col).Value2
        }

        # 方式二：用有序哈希表存储（以表头/列字母为键，适合按名称访问）
        $rowValuesHash = [ordered]@{}
        for ($col = 1; $col -le $lastColumn; $col++) {
            # 若第一行是表头，用表头作为键；否则用列字母（如A、B）
            $key = if ($row -ne 1) { $worksheet.Cells(1, $col).Value2 } else { [char](64 + $col) }
            $rowValuesHash[$key] = $worksheet.Cells($row, $col).Value2
        }

        # 后续可直接使用$rowValuesArray或$rowValuesHash处理数据
        Write-Host "整行值（数组形式）："
        $rowValuesArray | ForEach-Object { Write-Host "  $_" }
        
        Write-Host "整行值（哈希表形式）："
        $rowValuesHash | Format-Table -AutoSize

        # 若只需第一个匹配项，取消注释下面的代码跳出循环
        # break
    }
}

# ------------------- 清理资源 -------------------
# 释放COM对象，避免Excel进程残留
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($worksheet) | Out-Null
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($WorkBook) | Out-Null
[System.Runtime.Interopservices.Marshal]::ReleaseComObject($objExcel) | Out-Null
[System.GC]::Collect()
[System.GC]::WaitForPendingFinalizers()

关键细节说明 #

• 数据边界定位：使用End([Excel.XlDirection]::xlUp)和xlToLeft精准定位数据的最后一行/列，避免遍历大量空单元格，提升执行效率。
• 单元格值读取：优先使用Value2属性，它比Value更快，且返回原始数据（比如日期会返回底层数值而非格式化字符串）。
• 空值处理：遍历A列时跳过空单元格，防止$null与目标值匹配导致的误判。
• 数据存储选择：
  • 数组适合按列顺序快速访问数据；
  • 有序哈希表适合需要按表头/列名访问的场景，可读性更强。
• COM资源清理：必须手动释放Excel相关的COM对象并触发垃圾回收，否则Excel会在后台残留进程。

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