Laravel中maatwebsite/excel导出带+号手机号变公式问题求助

我之前也踩过一模一样的坑！带+号的手机号（比如+8613800138000）会被Excel当成公式开头，哪怕设置了@文本格式还是没用——这是因为Excel的格式优先级低于内容识别逻辑：如果内容开头是+，它会先判定为公式，再应用格式，这时候已经晚了。给你几个亲测有效的解决办法：

方法1：在映射时添加Excel文本前缀（最快最直接） #

Excel里，在文本前加一个单引号（'）会强制识别为纯文本，而且这个单引号不会在单元格里显示出来。你只需要在WithMapping的map方法里处理Phone和Mobile字段：

public function map($client): array
{
    return [
        $client->name,
        $client->identification_type,
        $client->tax_id,
        $client->email,
        $client->address,
        $client->country,
        $client->department,
        $client->zip,
        $client->fax,
        // 给Phone字段加单引号前缀
        "'" . $client->phone,
        // 给Mobile字段加单引号前缀
        "'" . $client->mobile,
        $client->date->format('d/m/Y'),
    ];
}

这个方法简单粗暴，适合快速解决单个导出类的问题。

方法2：自定义值绑定器（全局/批量处理更优雅） #

如果你的项目里有很多导出都需要处理这类带特殊前缀的文本，推荐用WithCustomValueBinder接口自定义绑定逻辑，从根源上强制指定文本类型：

步骤1：创建自定义ValueBinder类 #

namespace App\Exports\Binders;

use Maatwebsite\Excel\DefaultValueBinder;
use PhpOffice\PhpSpreadsheet\Cell\Cell;
use PhpOffice\PhpSpreadsheet\Cell\DataType;

class TextValueBinder extends DefaultValueBinder
{
    public function bindValue(Cell $cell, $value)
    {
        // 匹配所有以+开头的字符串，强制设为文本类型
        if (is_string($value) && str_starts_with($value, '+')) {
            $cell->setValueExplicit($value, DataType::TYPE_STRING);
            
            return true;
        }
        
        // 其他内容沿用默认绑定逻辑
        return parent::bindValue($cell, $value);
    }
}

步骤2：在导出类中使用这个绑定器 #

修改你的ClientsExport类，实现WithCustomValueBinder接口，并指定使用自定义绑定器：

use App\Exports\Binders\TextValueBinder;
use Maatwebsite\Excel\Concerns\WithCustomValueBinder;

class ClientsExport implements FromCollection, WithHeadings, WithMapping, WithColumnFormatting, WithCustomValueBinder {
    // 实现绑定方法
    public function bindValue($cell, $value)
    {
        return (new TextValueBinder())->bindValue($cell, $value);
    }

    // ... 你原有其他方法（headings、columnFormats等）保持不变
}

这个方法可以一次性解决所有带+前缀的文本识别问题，不用每个导出都单独处理。

方法3：检查并更新依赖版本 #

有时候旧版本的maatwebsite/excel或者phpoffice/phpspreadsheet存在格式处理的bug，确保你使用的是最新稳定版：

composer update maatwebsite/excel

为什么之前的columnFormats没用？ #

因为columnFormats是在内容写入到单元格之后再应用格式，而Excel会先根据内容开头的符号（比如+）判断为公式，这时候即使设置了文本格式，公式的识别已经完成了，所以无法逆转。必须在写入内容的同时强制指定为文本类型，才能避免这个问题。

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