Laravel Excel导出公式自动添加@符号致失效求助

问题原因 #

Maatwebsite Excel底层依赖PhpSpreadsheet，当你直接在单元格中写入数组公式字符串时，PhpSpreadsheet会自动添加@符号（隐式交集运算符）——它默认将普通单元格中的公式视为非数组公式，用@强制单值返回，直接破坏了数组公式的逻辑，导致出现#VALUE错误。

解决方案 #

方案1：标记单元格为数组公式 #

不要直接在collection方法中追加带公式的字符串，而是通过afterSheet事件操作单元格，显式将其设置为数组公式：

use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\AfterSheet;
use PhpOffice\PhpSpreadsheet\Cell\DataType;

class SheetTwo implements FromCollection, AfterSheet
{
    public function collection()
    {
        // 业务数据集
        $data = YourModel::all();
        
        // 追加合计占位行（最后一列留空，后续填充公式）
        $data->push(['', '', '', '', '']);
        
        return $data;
    }

    public function afterSheet($event)
    {
        $sheet = $event->sheet->getDelegate();
        $totalRow = $sheet->getHighestRow();
        $maxDataRow = $totalRow - 1; // 数据行的最后一行索引
        
        // 构造数组公式
        $formula = 'SUM(IF(SheetTwo!D2:D'.$maxDataRow.'<>"",1/COUNTIF(SheetTwo!D2:D'.$maxDataRow.',SheetTwo!D2:D'.$maxDataRow.'),0))';
        
        // 获取合计行的目标单元格（示例为E列最后一行）
        $targetCell = $sheet->getCell('E'.$totalRow);
        
        // 显式设置为数组公式，避免自动添加@
        $targetCell->setValueExplicit($formula, DataType::TYPE_FORMULA);
        $targetCell->setFormulaArray($formula);
    }
}

方案2：全局禁用隐式交集功能 #

通过PhpSpreadsheet的配置关闭自动添加@的行为，适合批量导出数组公式的场景：

use Maatwebsite\Excel\Concerns\FromCollection;
use PhpOffice\PhpSpreadsheet\Calculation\Calculation;

class SheetTwo implements FromCollection
{
    public function __construct()
    {
        // 禁用隐式交集，阻止自动插入@符号
        Calculation::getInstance()->setEnableImplicitIntersection(false);
    }

    public function collection()
    {
        $data = YourModel::all();
        $maxIndex = $data->count() + 1;
        
        // 直接追加带公式的行即可
        $data->push([
            '', '', '', '',
            '=SUM(IF(SheetTwo!D2:D'.$maxIndex.'<>"",1/COUNTIF(SheetTwo!D2:D'.$maxIndex.',SheetTwo!D2:D'.$maxIndex.'),0))'
        ]);
        
        return $data;
    }
}

验证 #

使用任意一种方案后，导出的XLSX文件中公式将不再包含额外的@符号，数组公式可正常计算，不会出现#VALUE错误。

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