Xlsxwriter：先设置列宽后用set_column分组失效问题咨询

嘿，我来帮你搞定这两个xlsxwriter的问题——自动调整列宽和列分组失效的坑，咱们一步步捋清楚：

xlsxwriter没有内置的自动列宽适配函数，所以得自己手动计算每列的最大字符长度，再给每列单独设置宽度。这里要注意两个点：一是非字符串类型（比如数字、日期）要转成字符串计算长度；二是中文在Excel里占的宽度是英文的2倍，得额外处理（如果你的数据包含中文的话）。

给你个可直接复用的示例代码：

import xlsxwriter

# 示例数据（包含不同长度的文本、数字）
data = [
    ["姓名", "年龄", "详细地址", "备注信息"],
    ["张三", 25, "北京市朝阳区建国路88号院1号楼", "这是一条超过20个字符的超长备注"],
    ["李四", 30, "上海市黄浦区南京东路123号", "短备注"],
    ["王老五", 45, "广州市天河区珠江新城花城广场", "中等长度的备注内容"]
]

# 创建工作簿和工作表
workbook = xlsxwriter.Workbook('auto_width_group.xlsx')
worksheet = workbook.add_worksheet()

# 第一步：先把所有数据写入工作表
for row_idx, row_data in enumerate(data):
    for col_idx, cell_val in enumerate(row_data):
        worksheet.write(row_idx, col_idx, cell_val)

# 第二步：计算每列的最大宽度
max_col_widths = [0] * len(data[0])  # 初始化每列最大宽度为0

for row in data:
    for col_idx, cell_val in enumerate(row):
        # 把所有值转成字符串，计算长度
        cell_str = str(cell_val)
        # 中文特殊处理：每个中文占2个字符宽度，用gbk编码计算更准确（避免emoji等特殊字符干扰）
        cell_width = len(cell_str.encode('gbk'))
        # 更新该列的最大宽度
        if cell_width > max_col_widths[col_idx]:
            max_col_widths[col_idx] = cell_width

# 第三步：给每列设置宽度，额外加2个字符的余量避免太挤
for col_idx, width in enumerate(max_col_widths):
    worksheet.set_column(col_idx, col_idx, width + 2)

你遇到的分组没生效、列宽异常，大概率是下面几个原因之一：

1. 列索引搞混了（0-based vs Excel的1-based） #

xlsxwriter的列是从0开始计数的（对应Excel的A列是0，B列是1，以此类推）。如果你用了Excel的列号（比如把A列当成1）来设置分组范围，肯定会错配到其他列。

错误示例：想分组A-B列（对应索引0-1），却写成了worksheet.set_column(1,2, ...)，实际会分组B-C列。

2. set_column的顺序搞反了，后设置的覆盖了前设置的 #

xlsxwriter的set_column是覆盖式的：如果先设置了单列的宽度，再设置该列所在的分组范围，分组的设置会覆盖单列的宽度；反之，如果先设置分组再设置单列宽度，单列的设置会覆盖分组的level等参数。

错误示例：

# 先设置单列宽度
worksheet.set_column(0,0, 15)
worksheet.set_column(1,1, 10)
# 再设置分组，这时候分组的level会生效，但之前的列宽会被覆盖成默认值
worksheet.set_column(0,1, None, None, {'level':1, 'collapsed':True})

正确做法：先给分组列设置level，再单独设置每列宽度（设置宽度时要带上level参数）：

# 先给0-1列设置分组级别
worksheet.set_column(0,1, None, None, {'level':1})
# 再单独设置每列宽度，同时保留分组级别
worksheet.set_column(0,0, max_col_widths[0]+2, None, {'level':1})
worksheet.set_column(1,1, max_col_widths[1]+2, None, {'level':1})
# 最后设置折叠效果
worksheet.set_column(0,1, None, None, {'collapsed':True, 'hidden':True})

3. 分组的参数不全 #

分组生效需要至少设置level参数（表示分组层级，从1开始）；如果要实现折叠效果，还需要同时设置collapsed=True和hidden=True。如果只设置了level，分组会显示但不会折叠。

4. 分组时错误指定了固定宽度，覆盖了自动计算的列宽 #

如果你在设置分组的set_column里指定了宽度值（比如set_column(0,1, 12, ...)），会直接覆盖之前自动计算的列宽，导致该分组内的列都变成固定宽度，出现异常。

最后给你一个结合自动列宽和正确分组的完整示例：

# 接上面的自动列宽代码，现在要分组姓名（0列）和年龄（1列）
# 给分组列设置级别
worksheet.set_column(0,1, None, None, {'level':1})
# 单独设置每列宽度（分组列要带上level参数）
for col_idx, width in enumerate(max_col_widths):
    if col_idx in [0,1]:
        worksheet.set_column(col_idx, col_idx, width + 2, None, {'level':1})
    else:
        worksheet.set_column(col_idx, col_idx, width + 2)
# 设置折叠效果
worksheet.set_column(0,1, None, None, {'collapsed':True, 'hidden':True})

# 关闭工作簿
workbook.close()

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