Apache POI里setColumnWidth为什么没生效
调用 sheet.setColumnWidth(colIndex, width) 后列宽看起来没变，大概率是单位搞错了。POI的列宽单位不是像素，也不是字符数，而是“1/256个字符宽度”（基于默认字体的0字符宽度）。比如设成 256，实际只占1个字符宽；常见写法 sheet.setColumnWidth(0, 30 * 256) 才能撑开约30字符。
必须在写入数据之后、workbook.write() 之前调用，否则部分版本会忽略如果用 autoSizeColumn() 自动调整过，再手动设宽会被覆盖，得先调 sheet.autoSizeColumn(i, false) 关掉自动行为Excel里最小列宽是1，对应POI值为 256；最大约255字符宽，即 255 * 256 = 65280，超了会静默截断
CellStyle里setWidth和setColumnWidth的区别
CellStyle 根本没有 setWidth 方法——这是常见误搜点。有人把CSS或前端表格API的习惯带进来了。POI中控制列宽只有两个入口：Sheet.setColumnWidth()（整列）和 Sheet.setColumnWidths()（批量），跟 CellStyle 完全无关。
CellStyle 能管的是单元格内容对齐、字体、边框、背景色等渲染样式，但不参与列宽计算如果你看到某段代码在 CellStyle 上调用 setWidth()，那要么是伪代码，要么是混淆了其他库（如JXLS、EasyExcel）真想让内容“撑开列宽”，得靠 sheet.autoSizeColumn(i)，它会扫描该列所有单元格内容+字体+字号来估算宽度
中文内容下autoSizeColumn列宽偏窄怎么办
默认 autoSizeColumn() 基于Excel内置的“标准字符宽度”估算，对中文兼容性差——它把一个汉字当0.7个英文字符算，结果列宽明显不够，文字被截断或换行。
临时解法：调用后立刻补加固定宽度，比如 sheet.setColumnWidth(i, sheet.getColumnWidth(i) + 2 * 256)更稳的做法是自己算：读取单元格字符串长度，中文字符按1.2~1.5倍权重加权，再乘以256，最后用 setColumnWidth 覆盖注意 autoSizeColumn(i, true) 的第二个参数表示“是否忽略合并单元格”，设为 false 可避免因合并导致宽度归零
导出到Excel 2007+（.xlsx）和2003（.xls）的宽度差异
POI对两种格式的列宽处理逻辑一致，但Excel 2003（HSSFWorkbook）有硬限制：最大列宽只能到 255 字符（即 65280），而.xlsx（XSSFWorkbook）理论上支持更大，不过Excel客户端仍会截断到255。所以别指望用POI突破这个上限。
立即学习“Java免费学习笔记（深入）”；
如果目标用户主要用WPS或旧版Excel，建议统一按 250 * 256 封顶，避免打开报错或显示异常XSSFWorkbook 下设置超宽列时，POI不会报错，但Excel打开后可能自动缩回255字符宽，且不提示跨版本兼容写法：统一用 Math.min(width, 250 * 256) 包一层，比事后调试省事
事情说清了就结束。列宽这事看着简单，但单位、时机、格式、中英文混排四层坑叠在一起，漏掉任意一层都得花十分钟翻源码确认。
评论(0)