Python使用xlsxwriter调用freeze_panes无法冻结Excel首行怎么解决

• 未获取到有效工作表对象
  xlsxwriter仅支持创建全新的Excel文件，不支持读取已存在的Excel文件内容，也无法识别未通过add_worksheet()主动创建的工作表。如果你没有提前执行workbook.add_worksheet(k)创建名称为k的工作表，get_worksheet_by_name(k)会返回None，后续所有对currentWorksheet的操作（包括freeze_panes）都会静默失效，不会抛出报错。
• 未正确关闭工作簿对象
  xlsxwriter的所有写入/配置操作都只在内存中生效，必须在所有操作结束后执行workbook.close()，修改才会被写入到最终的xlsx文件中。如果遗漏了这一步，冻结窗格的配置自然不会出现在生成的文件里。
• Excel查看器兼容问题
  少数轻量Excel查看器（比如部分在线预览工具、老版本WPS兼容模式）不支持识别冻结窗格配置，也会出现看起来未生效的问题。

1. 优先直接获取新建工作表的对象，不要用get_worksheet_by_name获取刚创建的工作表，参考修改后的代码：

import xlsxwriter 

workbook = xlsxwriter.Workbook(XLSX_FILE)
# 先创建工作表，直接获取有效对象
currentWorksheet = workbook.add_worksheet(k)

currentWorksheet.write("A1", "User ID")
currentWorksheet.write("B1", "Name")
currentWorksheet.write("C1", "Email")
currentWorksheet.write("D1", "Mobile App access")
currentWorksheet.write("E1", "Dashboard access")
currentWorksheet.write("F1", "Registrations complete")

currentWorksheet.freeze_panes(1, 0) # 此处参数正确，作用为冻结首行

# 必须添加关闭工作簿的步骤
workbook.close()

2. 如果确实需要通过名称获取已创建的工作表，可增加校验逻辑避免操作空对象：

currentWorksheet = workbook.get_worksheet_by_name(k)
if not currentWorksheet:
    raise ValueError(f"不存在名为{k}的工作表")

3. 生成文件后用完整版微软Excel或新版WPS打开验证，排除查看器兼容问题。

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