如何使用 Python openpyxl 包操作 Excel 链接？openpyxl Hyperlink 对象介绍

Python openpyxl 包中的 Excel 链接对象 Hyperlink

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

使用 Python openpyxl 包的 Hyperlink 对象创建 Excel 链接

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

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

ref 参数

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

location 参数

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

tooltip 参数

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

display 参数

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

id 参数

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

target 参数

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

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

使用 Python openpyxl 包的 Cell 对象获取和设置 Excel 链接

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

cell.hyperlink
cell.hyperlink = link

link 值

link是一个表示 Excel 链接的Hyperlink对象，或者是一个表示链接目标的字符串（他将对应Hyperlink对象的target变量），比如'https://www.bing.com/'。要移除 Excel 单元格中的链接，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

使用 Python openpyxl 包的 Cell 对象修改 Excel 链接

对于 Pythonopenpyxl包的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')

使用 Python openpyxl 包的 Cell 对象移除 Excel 链接

你可以通过将 Pythonopenpyxl包的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