Python 实现 Excel 命名范围（Named Range）的创建与管理

在处理复杂的 Excel 工作表时，直接使用单元格地址（如 A1:D10）来引用数据区域是一种常见但容易出错的方式。当公式和引用变多时，记住每个区域的含义几乎不可能。命名范围（Named Range）正是为了解决这个问题而设计的------它允许你给一段单元格区域赋予一个有意义的名称，从而让公式、数据引用和代码逻辑变得更加清晰。

本文将介绍如何使用 Python 在 Excel 中完成命名范围的创建、查询、修改、格式化、公式引用以及删除等操作。

环境准备

本文使用 Spire.XLS for Python 库来操作 Excel 文件。通过 pip 安装即可：

bash 复制代码

pip install Spire.XLS

安装完成后，在 Python 脚本中导入所需模块：

python 复制代码

from spire.xls import *
from spire.xls.common import *

创建命名范围

命名范围的核心思路是将一段单元格区域与一个名称绑定。创建时，先通过 NameRanges.Add() 方法添加一个新的命名范围对象，再将 RefersToRange 属性指向具体的单元格区域。

python 复制代码

workbook = Workbook()
workbook.LoadFromFile("input.xlsx")
sheet = workbook.Worksheets[0]

# 创建命名范围并绑定到指定区域
named_range = workbook.NameRanges.Add("SalesData")
named_range.RefersToRange = sheet.Range["A1:E20"]

workbook.SaveToFile("output.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

这里 NameRanges.Add() 返回的是一个 INamedRange 对象，通过设置其 RefersToRange 属性，就完成了名称与区域的关联。之后在 Excel 公式或代码中，就可以直接使用 SalesData 这个名称来代替 A1:E20。

全局命名范围与工作表级命名范围

Excel 中的命名范围有两个作用域：全局（工作簿级别）和局部（工作表级别）。全局命名范围在整个工作簿中都可用，而工作表级命名范围仅在所属工作表内有效。

全局命名范围通过 workbook.NameRanges 创建：

python 复制代码

named_range = workbook.NameRanges.Add("GlobalRange")
named_range.RefersToRange = sheet.Range["A1:D10"]

工作表级命名范围则通过 sheet.Names 创建：

python 复制代码

named_range = sheet.Names.Add("LocalRange")
named_range.RefersToRange = sheet.Range["A1:D19"]

在多个工作表需要各自独立定义同名区域时，工作表级命名范围尤其有用。

查询命名范围

获取所有命名范围

遍历 NameRanges 集合可以获取工作簿中所有的命名范围：

python 复制代码

workbook = Workbook()
workbook.LoadFromFile("input.xlsx")

for name_range in workbook.NameRanges:
    print(name_range.Name)

workbook.Dispose()

获取特定命名范围

可以通过索引或名称来获取特定的命名范围对象：

python 复制代码

# 通过索引获取
range_by_index = workbook.NameRanges[1]

# 通过名称获取
range_by_name = workbook.NameRanges["SalesData"]

获取命名范围的地址信息

通过 RefersToRange 属性可以获取命名范围所指向的单元格区域及其地址：

python 复制代码

named_range = workbook.NameRanges[0]
cell_range = named_range.RefersToRange
address = cell_range.RangeAddress

print(f"命名范围 {named_range.Name} 的地址为 {address}")

根据单元格区域反查命名范围

如果已知某个单元格区域，想确认它是否已被定义为命名范围，可以使用 GetNamedRange() 方法：

python 复制代码

sheet = workbook.Worksheets[0]
cell_range = sheet.Range["A2:D2"]
result = cell_range.GetNamedRange()

if result is not None:
    print(f"该区域对应的命名范围: {result.Name}")

这在需要检查某段区域是否已有命名范围绑定时非常实用。

重命名命名范围

通过直接修改 Name 属性即可对已有的命名范围进行重命名：

python 复制代码

workbook.NameRanges[0].Name = "UpdatedRangeName"

重命名后，所有引用该名称的公式会自动更新------这与 Excel 本身的行为一致。

对命名范围区域进行格式化

获取到命名范围后，可以对其指向的单元格区域进行格式化操作。这在需要突出显示特定数据区域时很方便：

python 复制代码

workbook = Workbook()
workbook.LoadFromFile("input.xlsx")

named_range = workbook.NameRanges[0]
cell_range = named_range.RefersToRange

# 设置背景色
cell_range.Style.Color = Color.get_Yellow()

# 设置字体加粗
cell_range.Style.Font.IsBold = True

workbook.SaveToFile("formatted_output.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

通过 RefersToRange 获取到的区域对象与普通区域对象的用法完全一致，因此可以对其进行任何常规的样式设置。

合并命名范围的单元格

命名范围所覆盖的单元格区域同样支持合并操作：

python 复制代码

named_range = workbook.NameRanges[0]
cell_range = named_range.RefersToRange

# 合并单元格
cell_range.Merge()

合并操作会将区域内的所有单元格合并为一个单元格，通常用于创建跨列的标题行。

在公式中使用命名范围

命名范围最有价值的用途之一是在公式中替代硬编码的单元格地址。下面的示例展示了如何为一段区域定义命名范围，然后在 SUM 公式中直接使用该名称：

python 复制代码

workbook = Workbook()
workbook.LoadFromFile("input.xlsx")
sheet = workbook.Worksheets[0]

# 创建命名范围
named_range = workbook.NameRanges.Add("ScoreRange")
named_range.RefersToRange = sheet.Range["B10:B12"]

# 在公式中引用命名范围
sheet.Range["B13"].Formula = "=SUM(ScoreRange)"

# 填入数据
sheet.Range["B10"].Value2 = Int32(10)
sheet.Range["B11"].Value2 = Int32(20)
sheet.Range["B12"].Value2 = Int32(30)

workbook.SaveToFile("formula_output.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

使用命名范围后，公式的可读性显著提升。当数据区域发生变化时，只需更新命名范围的 RefersToRange，无需逐一修改公式中的地址引用。

删除命名范围

删除命名范围支持按索引和按名称两种方式：

python 复制代码

workbook = Workbook()
workbook.LoadFromFile("input.xlsx")

# 按索引删除
workbook.NameRanges.RemoveAt(0)

# 按名称删除
workbook.NameRanges.Remove("SalesData")

workbook.SaveToFile("output.xlsx", ExcelVersion.Version2010)
workbook.Dispose()

需要注意的是，删除命名范围后，引用该名称的公式会出现错误。在执行删除操作前，建议先检查是否有公式依赖该命名范围。

实用技巧

命名规范 ：命名范围的名称不能包含空格，不能以数字开头，也不能与单元格地址（如 A1）重名。建议使用驼峰命名或下划线分隔的方式，如 SalesData 或 sales_data。
作用域选择：如果命名范围仅在某一个工作表内使用，优先使用工作表级命名范围，避免名称冲突。
动态更新 ：当数据区域的行数经常变化时，可以通过代码重新设置 RefersToRange 来动态更新命名范围的覆盖范围。

总结

命名范围是 Excel 中提升公式可读性和数据管理规范性的基础功能。通过 Python 编程，可以将命名范围的创建、查询、修改和清理等操作自动化，特别适合在批量处理 Excel 文件或构建自动化报表系统时使用。

本文涵盖了命名范围的主要操作：创建全局和工作表级命名范围、按索引和名称查询、获取地址信息、重命名、格式化、合并单元格、在公式中引用以及删除。在实际项目中，可以根据具体需求组合使用这些操作，构建更加灵活和可维护的 Excel 数据处理流程。