使用xlsxwriter写入Excel：如何隐藏开头为=的单元格转义单引号？

问题原因 #

XlsxWriter的write()方法会自动判断内容类型，当单元格内容以=开头时，会被识别为公式尝试解析，若内容并非合法公式就会触发报错。手动在Excel中加单引号是专属的交互输入技巧，直接在代码里给内容加单引号会被当成普通字符显示，无法达到预期的隐藏转义效果。

解决方案 #

以下是几种可行的解决方式，按推荐优先级排序：

1. 使用write_string()强制写入字符串

把代码中的write()替换为write_string()方法，该方法会强制将内容以纯文本形式写入Excel，不会解析为公式，无需额外添加转义字符：

spam_catch = current_sheet.write_string(
    f"{setting['column']}{row_number}",
    cell_output
)

2. 预定义文本格式并指定写入

先创建一个文本格式，写入单元格时指定该格式，Excel会将单元格内容视为纯文本：

# 在创建workbook后添加文本格式定义
text_format = workbook.add_format({'num_format': '@'})

# 写入时指定格式
spam_catch = current_sheet.write(
    f"{setting['column']}{row_number}",
    cell_output,
    text_format
)

3. 结合Pandas指定列类型（若使用Pandas写入）

如果是通过Pandas的to_excel写入数据，可以提前将目标列设置为字符串类型，避免自动解析：

# 将Spark DataFrame转为Pandas DataFrame
pandas_df = sheet_data.toPandas()
# 将目标列设为字符串类型
pandas_df[setting['column']] = pandas_df[setting['column']].astype(str)
# 写入Excel
pandas_df.to_excel(writer, sheet_name=sheet_name, index=False)

效果说明 #

以上方法都能让以=开头的内容正常显示在Excel中，不会触发公式报错，也不会额外显示转义用的单引号。

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