PHP Spreadsheet列可见性判断异常：隐藏列始终返回可见

核心问题出在getColumnDimension()的参数使用错误：该方法要求传入列字母标识（如'A'、'B'），而非数字索引。你代码中直接传入数字$col，会导致方法返回默认的列维度对象，默认可见性始终为true（即返回1），自然无法识别隐藏列。

修正方案 #

1. 使用PHP Spreadsheet内置的Coordinate::stringFromColumnIndex()方法，将数字列索引转换为字母标识；
2. 部分隐藏列可能仅通过设置宽度为0实现，建议同时结合列宽度判断，提升兼容性。

修正后代码示例 #

use PhpOffice\PhpSpreadsheet\Cell\Coordinate;

for ($col = 0; $col <= $highestColumnIndex; ++$col) {
    // 转换数字索引为列字母（该方法接收从1开始的列数，所以+1）
    $colLetter = Coordinate::stringFromColumnIndex($col + 1);
    $colDimension = $worksheet1->getColumnDimension($colLetter);
    
    // 同时判断可见性和列宽度，兼容不同隐藏方式
    $isVisible = $colDimension->getVisible() && ($colDimension->getWidth() !== 0);
    
    if ($isVisible) {
        $worksheet2->setCellValueByColumnAndRow(1, $col + 1, 'Col: ' . $colLetter . ' Visible');
    } else {
        $worksheet2->setCellValueByColumnAndRow(2, $col + 1, 'Col: ' . $colLetter . ' Not Visible');
    }
}

补充说明 #

• 行隐藏判断正常是因为getRowDimension()支持直接传入数字索引，和列方法的参数规则不同，这也是行判断没问题但列失效的关键差异；
• 若某列从未被自定义设置过（无宽度调整、隐藏操作），getColumnDimension()会返回默认维度对象，此时可见性为默认true，结合宽度判断可覆盖这类场景。

内容的提问来源于stack exchange，提问作者d_codesys