ImportExcel模块仅读取到AF2列，保存文件后恢复正常求助

问题现象 #

使用ImportExcel模块执行以下代码时，返回的工作表维度为A1:AF2，但实际Excel文件中AF列右侧还有更多数据；手动打开文件按Ctrl+S保存（无修改）后，代码返回正确的A1:BA2范围。

$ExcelFilePath = "C:\Users\<xxx>\code\<xxx>\<xxx>\AllSqlServersV2.xlsx"
$Excel = Open-ExcelPackage -Path $ExcelFilePath
$Excel.Recommended_for_instances.Dimension

原因分析 #

• Excel已用范围元数据未更新：Excel内部会记录工作表的「已用范围（UsedRange）」元数据，当在原有范围外添加数据后，Excel不会自动实时更新这个元数据。ImportExcel依赖的EPPlus库会读取该元数据判定工作表维度，因此返回旧的范围。手动保存文件时，Excel会自动刷新已用范围的元数据，后续读取就会得到正确结果。
• 非有效数据未被识别：如果AF列右侧的单元格仅包含格式设置（如颜色、边框）或返回空值的公式，EPPlus默认不会将这些单元格纳入已用范围，直到Excel保存时重新计算并更新元数据。

解决办法 #

1. 手动刷新（最简单方式） #

直接打开目标Excel文件，按Ctrl+S保存后再用ImportExcel读取，Excel会自动更新已用范围元数据。

2. PowerShell中强制刷新已用范围 #

通过调用EPPlus的API强制刷新工作表的已用范围，无需手动打开文件：

$ExcelFilePath = "C:\Users\<xxx>\code\<xxx>\<xxx>\AllSqlServersV2.xlsx"
$Excel = Open-ExcelPackage -Path $ExcelFilePath -Mode OpenOrCreate
$worksheet = $Excel.Recommended_for_instances

# 强制触发已用范围刷新
$worksheet.Calculate()
$worksheet.Dimension.Refresh()

# 查看更新后的维度
$worksheet.Dimension

# 保存并释放资源
$Excel.Save()
$Excel.Dispose()

3. 手动指定读取范围 #

如果已知实际数据的列范围，直接在代码中指定读取范围，绕过自动维度识别：

# 读取A1到BA2的所有数据
$data = Import-Excel -Path $ExcelFilePath -WorksheetName "Recommended_for_instances" -Range "A1:BA2"

4. 清理无效单元格 #

若右侧列仅包含空单元格或格式数据，可清除这些列的格式和空内容后保存文件，让Excel正确记录已用范围。

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