setColumnWidth没生效主要是单位错误，需用“1/256字符宽”单位，如30字符宽应设为30*256；须在写入数据后、workbook.write()前调用，且避免被autoSizeColumn覆盖；最大列宽为255字符（65280），超限会静默截断。
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个英文字符算，结果列宽明显不够，文字被截断或换行。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 临时解法：调用后立刻补加固定宽度，比如
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突破这个上限。
- 如果目标用户主要用WPS或旧版Excel，建议统一按
250 * 256封顶，避免打开报错或显示异常 -
XSSFWorkbook下设置超宽列时，POI不会报错，但Excel打开后可能自动缩回255字符宽，且不提示 - 跨版本兼容写法：统一用
Math.min(width, 250 * 256)包一层，比事后调试省事
事情说清了就结束。列宽这事看着简单，但单位、时机、格式、中英文混排四层坑叠在一起，漏掉任意一层都得花十分钟翻源码确认。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
