在使用 Laravel-Excel 的 WithEvents 功能动态设置 Excel 样式时，调用 getColumnDimension()->getWidth() 获取自动调整列宽（autoSize）的列尺寸会返回 -1.0，这是 PhpSpreadsheet 的标准标识值，需手动计算实际宽度。
在使用 laravel-excel 的 withevents 功能动态设置 excel 样式时，调用 `getcolumndimension()->getwidth()` 获取自动调整列宽（autosize）的列尺寸会返回 -1.0，这是 phpspreadsheet 的标准标识值，需手动计算实际宽度。
当启用列自动宽度（setAutoSize(true)）后，PhpSpreadsheet 不再维护固定像素或字符宽度值，而是将 width 属性设为 -1.0 作为“未显式设定、依赖内容计算”的标记。因此，直接读取 getWidth() 返回 -1.0 并非错误，而是设计使然。
若需在事件中（如 AfterSheet）基于列宽进行图像定位、单元格合并或样式偏移等操作（例如将图片精确居中于 B1 单元格），必须主动估算该列的实际渲染宽度。PhpSpreadsheet 内部对 autoSize 列的宽度计算逻辑基于字体、字号及内容长度，但不对外暴露实时计算接口。实践中，可采用以下两种可靠策略：
✅ 推荐方案：预设合理默认宽度 + 条件回退
在启用 autoSize 前，先为关键列（如 B 列）设置一个兼顾内容与布局的基准宽度，再按需微调：
// 在 registerEvents() 中，优先设置合理默认宽度（单位：字符）
$sheet = $event->sheet->getDelegate();
$columnB = $sheet->getColumnDimension('B');
$columnB->setAutoSize(true);
// 同时设置一个 fallback 宽度（避免 getWidth() 为 -1 时无法计算）
$columnB->setWidth(25); // 此值仅作 getWidth() 回退参考，不影响 autoSize 生效✅ 兼容方案：检测 -1 后使用经验性估算值
若必须依赖运行时宽度（如动态计算图片 left 偏移），可按如下方式安全处理：
$colDim = $event->sheet->getDelegate()->getColumnDimension('B');
$rawWidth = $colDim->getWidth();
// -1 表示 autoSize 模式，采用经验估算（通常 1 字符 ≈ 7–8px；Excel 默认字体 Calibri 11pt 下，1 字符宽 ≈ 7.5px）
$effectiveWidth = ($rawWidth == -1)
? 22.2 // 对应约 167px（常见 B 列 autoSize 合理范围），可根据实际字体/内容微调
: $rawWidth;
// 示例：计算图片在 B1 单元格内水平居中的 left 值（单位：px）
$cellX = \PhpOffice\PhpSpreadsheet\Shared\Coordinate::columnIndexFromString('B') - 1;
$leftOffset = ($effectiveWidth * 7.5 - $imageWidth) / 2; // 7.5px/char 为典型换算系数⚠️ 注意事项：
- setWidth() 与 setAutoSize(true) 可共存，但 getWidth() 仍返回 -1 —— 这是 PhpSpreadsheet 的已知行为，勿误判为 bug；
- 图片精确定位建议结合 setCoordinates() 和 setOffsetX()（单位为 EMU，1 EMU = 1/914400 inch），而非单纯依赖列宽像素值；
- 若布局要求极高，推荐禁用 autoSize，改用 setWidth() 手动控制列宽，确保可预测性；
- Laravel-Excel v3.1+ 基于 PhpSpreadsheet 1.23+，其 autoSize 计算逻辑已优化，但仍不提供运行时宽度 API。
总之，面对 -1.0，核心原则是：接受它是 autoSize 的语义标识，而非错误值；通过预设 fallback、经验估算或重构布局逻辑来规避依赖实时宽度的强耦合设计。
立即学习“PHP免费学习笔记（深入）”；
