如何使用 openpyxl 处理 Excel 链接？Hyperlink 对象介绍

openpyxl Excel 链接对象 Hyperlink

openpyxl包中的Hyperlink类，属于模块openpyxl.worksheet.hyperlink，用于表示 Excel 单元格中的链接。

创建 Excel 链接

使用Hyperlink对象的构造器，你可以创建新的 Excel 链接，这些链接可被设置到工作表的某个单元格中。

Hyperlink(ref=None, location=None, tooltip=None, display=None, id=None, target=None)

ref 参数

ref参数是一个字符串，表示含有链接的单元格的地址，比如'A1'。通过该参数赋值的ref变量，可能会被openpyxl修改，因此，这里的ref参数是无关紧要的，如果开发人员自行创建Hyperlink对象的话。

location 参数

location参数是一个字符串，表示链接指向的单元格或区域的地址，其格式为worksheet!address（比如，SheetB!A1），其中worksheet为工作表名称，address为地址，如果指向的是本工作表中的单元格或区域，则worksheet和!可以省去（比如，A1:B2）。

tooltip 参数

tooltip参数是一个字符串，他表示链接对应的工具提示。需要说明的是，即便设置了tooltip，一些 Office 软件也不会按照tooltip给出的值来显示工具提示。

display 参数

display参数是一个字符串，他表示链接在其对应的单元格中应该显示的文本，需要指出，单元格中最终显示的内容是由Cell对象的value属性来决定的。

id 参数

id参数是一个字符串，用于标识链接。如果链接对应的target变量不为None，那么通过参数id赋值的id变量，可能会被openpyxl包在保存 Excel 文件时修改，当id变量为None，或者id变量的值不符合要求时。

target 参数

target参数是一个字符串，他可能是某个网络地址（比如，以http，https，mailto开头的地址），或者是某个 Excel 文件的路径（可以是相对路径或绝对路径）。

在读取 Excel 文件时，openpyxl包会创建链接对象Hyperlink。如果链接并未指向单元格或区域，那么Hyperlink对象的location变量可能为 Python 空值None。如果链接指向单元格或区域，那么Hyperlink对象的id变量可能为 Python 空值None。如果链接指向本工作表中的单元格或区域，那么Hyperlink对象的target变量可能为 Python 空值None。

获取和设置 Excel 链接

Cell对象的hyperlink属性，可用于获取或设置 Excel 单元格中的链接。hyperlink属性的返回值是一个Hyperlink对象，如果单元格未包含链接，则Cell对象的hyperlink属性返回空值None。

cell.hyperlink
cell.hyperlink = link

link 值

link是一个表示链接的Hyperlink对象，或者是一个表示链接目标的字符串（他将对应Hyperlink对象的target变量），比如'https://www.bing.com/'。要移除单元格中的链接，link应该为空值None。

# 打开 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
wb = openpyxl.load_workbook('Link.xlsx')
ws = wb['Hyperlinks']


# 显示区域 A1:A2 中的单元格的链接
for row in ws['A1:A2']:
	for cell in row:
		print(f'{cell.hyperlink}, {cell.hyperlink.target}')


from openpyxl.worksheet.hyperlink import Hyperlink
# B1 单元格不会显示为 Google，而是 https://www.google.com/，参数 ref 并不正确，但没有关系
ws['B1'].hyperlink = Hyperlink('XXXX', display='Google', target='https://www.google.com/')
# 直接通过网址来设置 Excel 链接
ws['C1'].hyperlink = 'https://www.python.org'
# 指向工作表 Other 的 A1 单元格的链接
ws['D1'].hyperlink = Hyperlink('D1', location='Other!A1')
# 指向本工作表的 A1 单元格的链接
ws['E1'].hyperlink = Hyperlink('E1', location='A1')


wb.save('Google.xlsx')

…
ref='A1', location=None, tooltip=None, display='Bing', id='rId1', https://www.bing.com/
…
ref='A2', location='Other!B1:B4', tooltip=None, display='Other 的 B1:B4 区域', id=None, None

修改 Excel 链接

对于Cell对象的hyperlink属性所返回的Hyperlinks对象，你可以通过其变量来达到修改 Excel 链接的目的。

# 打开 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
workbook = openpyxl.load_workbook('Link.xlsx')
worksheet = workbook['Hyperlinks']


link = worksheet['A2'].hyperlink
# 修改工具提示和指向的单元格地址
link.tooltip = '一个大概不会显示的工具提示'
link.location = 'Other!A1'
# 修改 display 不影响单元格的内容，因此修改 value 属性
worksheet['A2'].value = '指向 Other 的 A1'
link.display = '不影响单元格内容'


workbook.save('Modify.xlsx')

# 打开 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
workbook = openpyxl.load_workbook('Link.xlsx')
worksheet = workbook['Hyperlinks']


# 移动单元格 A1，A2 至 D1，D2
worksheet.move_range('A1:A2', cols=3)
# 修改 D1 单元格的链接的 ref
worksheet['D1'].hyperlink.ref = 'D1'


workbook.save('Move.xlsx')

移除 Excel 链接

你可以通过将Cell对象的hyperlink属性设置为None，来移除对应 Excel 单元格中的链接，但链接的相关信息（比如，某个网址或显示文本）可能会被保留在单元格中，因为将hyperlink设置为None并不影响Cell的value属性。

# 打开 Link.xlsx 中的工作表 Hyperlinks
import openpyxl
workbook = openpyxl.load_workbook('Link.xlsx')
worksheet = workbook['Hyperlinks']


# 删除 A1 单元格中的链接
worksheet['A1'].hyperlink = None


workbook.save('Remove.xlsx')

源码

src/zh/openpyxl/cells/hyperlinks·codebeatme/office-programming·GitHub