PHPSpreadsheet 的 getColumnDimension() 方法仅接受字母列标（如 'A'），若传入数字索引会导致行为异常；应改用 getColumnDimensionByColumn() 并传入整数列号，才能准确获取列的可见性状态。
phpspreadsheet 的 `getcolumndimension()` 方法仅接受字母列标（如 'a'），若传入数字索引会导致行为异常；应改用 `getcolumndimensionbycolumn()` 并传入整数列号，才能准确获取列的可见性状态。
在使用 PHPSpreadsheet 处理 Excel 文件时，常需跳过隐藏列以提升处理效率或避免数据污染。但许多开发者会误用 getColumnDimension($col) 方法——该方法签名明确要求传入字符串形式的列字母（例如 'A', 'Z', 'AA'），而非数字索引（如 0, 1, 26）。若错误传入整数，PHPSpreadsheet 会静默返回一个默认的 ColumnDimension 实例，其 getVisible() 始终返回 true（即 1），导致“所有列都可见”的假象。
✅ 正确做法是：使用专为数字索引设计的方法 getColumnDimensionByColumn(int $columnIndex)。该方法接受从 1 开始的列号（注意：不是从 0 起始），并返回对应列的真实维度配置。
以下是完整、可运行的示例代码：
解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
// 假设 $spreadsheet 已加载，$worksheet1 为目标工作表
$worksheet1 = $spreadsheet->getActiveSheet();
$highestColumnIndex = $worksheet1->getHighestColumn(); // 返回 'Z' 或 'AA' 等
$highestColumnNumber = \PhpOffice\PhpSpreadsheet\Cell\Coordinate::columnIndexFromString($highestColumnIndex); // 转为数字，如 'Z' → 26, 'AA' → 27
// 注意：getColumnDimensionByColumn() 的参数是 1-based 列号（A=1, B=2, ..., Z=26）
for ($colNum = 1; $colNum <= $highestColumnNumber; $colNum++) {
$columnDimension = $worksheet1->getColumnDimensionByColumn($colNum);
$isVisible = $columnDimension->getVisible();
if ($isVisible) {
$worksheet2->setCellValueByColumnAndRow(1, $colNum, "Col {$colNum} (". \PhpOffice\PhpSpreadsheet\Cell\Coordinate::stringFromColumnIndex($colNum) .") is VISIBLE");
} else {
$worksheet2->setCellValueByColumnAndRow(2, $colNum, "Col {$colNum} (". \PhpOffice\PhpSpreadsheet\Cell\Coordinate::stringFromColumnIndex($colNum) .") is HIDDEN");
}
}? 关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
-
getColumnDimensionByColumn()的参数是 1-based 列号（A=1，B=2），不可传0； -
getHighestColumn()返回的是列字母（如'Z'），需用\PhpOffice\PhpSpreadsheet\Cell\Coordinate::columnIndexFromString()转为数字； - 反向转换（数字 → 字母）请使用
\PhpOffice\PhpSpreadsheet\Cell\Coordinate::stringFromColumnIndex($colNum)； - 行隐藏检测（
getRowDimension($row)->getVisible()）无此限制，因getRowDimension()接受整数行号，但列维度接口设计不同，务必区分。
总结：列可见性判断失败几乎总是源于方法选错——牢记 getColumnDimension(string $column) 用于字母标识，getColumnDimensionByColumn(int $columnIndex) 才用于数字索引。正确选用后，getVisible() 将如实返回 true 或 false，确保逻辑严谨可靠。
