poi的setcolumnwidth参数单位是1/256字符宽度，需用界面列宽×256计算；必须在写入数据后调用才生效；autosizecolumn对中文支持弱，需手动补偿。
setColumnWidth 参数单位不是像素，是 1/256 字符宽度
Java POI 的 setColumnWidth 方法接收的是「字符宽度 × 256」的整数值，不是像素、毫米或 Excel 界面里看到的“列宽数字”。Excel 界面显示的列宽（比如 12.0）乘以 256 才是 POI 要传的值。直接传 12 或 120 都会极窄——实际效果接近 0.05 列宽，单元格内容基本看不见。
- 正确换算：界面列宽 15 → 传
15 * 256 = 3840 - 常见误用：
sheet.setColumnWidth(0, 15)（太窄）、sheet.setColumnWidth(0, 1500)（约 5.87 列宽，仍偏小） - 注意：这个单位和字体无关，但默认字符宽度基于 Excel 默认字体（Calibri 11pt）下的「0」字符宽度
setColumnWidth 必须在写入数据后调用才生效
POI 的列宽设置对已存在的行内容不自动重排。如果先写入长文本、再调用 setColumnWidth，列宽变了，但内容仍按旧宽度换行或截断——尤其当单元格启用了 wrapText 时，视觉上毫无变化。
- 必须顺序：写完所有数据 → 调用
setColumnWidth→ 再写入样式（如CellStyle） - 如果边写边设宽（比如循环中每写一行就设一次），性能差且可能被后续写入覆盖
- 自动列宽？POI 没有
autoSizeColumn的精确等效，但sheet.autoSizeColumn(colIndex)可用，它基于当前列所有单元格内容长度估算，但只对字符串有效，数字/公式/富文本支持弱
中文内容下 autoSizeColumn 经常不准，得手动补偿
sheet.autoSizeColumn(0) 在含中文的单元格里往往偏窄——因为 POI 默认按英文字符宽度估算，一个中文≈2个英文字符，但它没自动翻倍。结果就是文字挤在一起、强制换行、甚至被截断。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 典型现象：单元格内容是“测试数据”，
autoSizeColumn后列宽仅够显示“测”字 - 临时解法：调用
autoSizeColumn后再手动加宽，例如sheet.setColumnWidth(0, sheet.getColumnWidth(0) + 1024)（+4 字符） - 更稳做法：预估最大中文字符数，按「中文字符数 × 2 × 256」设宽，比如最多 10 个汉字 →
10 * 2 * 256 = 5120
setColumnWidth 对隐藏列、合并单元格无副作用，但别在 forEach 循环里反复调用
该方法只影响单列物理宽度，不影响隐藏状态（setColumnHidden）或合并区域（addMergedRegion）。但它不是幂等操作：每次调用都会向 .xlsx 文件写入新宽度指令，高频调用（如在 for (int i = 0; i 中）会导致文件体积异常增大、生成变慢。
- 错误写法：
for (int i = 0; i —— 每列设 1000 次 - 正确写法：循环外统一设，或用
IntStream.range(0, header.length).forEach(i -> sheet.setColumnWidth(i, 3840)) - 注意：.xls（HSSF）和 .xlsx（XSSF）都支持该方法，但 XSSF 下列宽上限更高（约 255 字符），HSSF 实际上限约 100
实际项目里最常卡住的，是把界面看到的列宽数字直接当参数传，或者以为 autoSizeColumn 能一劳永逸。这两点不校验，导出的 Excel 打开第一眼就难看。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
