孙圈圈1. 从业务场景到技术选型：为什么你的导出方案总踩坑
做PHP开发这几年，几乎每个项目都逃不过表格导出这个需求。后台管理系统的订单列表、用户报表、财务对账单，甚至是前端页面上一个“一键导出”的按钮，背后都牵着一套导出逻辑。很多人第一次接到这个需求时，第一反应是：不就是把数据库里的数据循环一遍，写到文件里吗？真做起来才发现，坑一个接一个——数据量大了内存直接爆掉，导出的Excel在WPS里打开乱码，数字变成科学计数法，日期变成一串####，更离谱的是有的文件打不开，或者下载下来是空文件。这些我都踩过，所以这篇博客准备把这几年做导出功能的经验和坑一次性讲清楚。
先给这篇文章定个调：核心目标是让你拿到需求后，能快速选型、快速实现、快速上线，并且知道出了问题该往哪个方向排查。内容会围绕最常见的两种路线展开——使用PhpSpreadsheet这类成熟类库做功能完整的导出，以及用CSV或原生XML方式做轻量级导出。这两种方案对应的场景完全不同，选错了后面全是事。
先说结论，再做对比分析。如果你要导出的是几万行以内、格式要求不高、只要数据能看能统计的数据，CSV导出是最快最省事的方案；如果你的数据要带样式、要合并单元格、要有多个Sheet、要设置列宽和冻结窗口，那就老老实实用PhpSpreadsheet；如果你要做的是复杂报表模板，每次都从零构建样式会累死人，那就用模板填充或者前端导出方案。下面展开讲。
1.1 Excel导出的常见业务需求与实现路线
Excel导出这个需求的本质，是把服务端的数据按某种约定的格式交给用户，让用户可以在Excel、WPS这类软件里继续编辑和分析。拆开看，业务需求大概分三类：
- 纯数据导出：就是把查询结果原样输出，行对行、列对列，不带任何样式，用户拿到手自己再排版。这类需求最常见，订单明细、日志列表、通讯录都属于这一类。
- 带格式导出：要求导出文件里有表头颜色、列宽设置、冻结首行、自动筛选、货币格式、日期格式等。财务对账单、销售报表、工资条这类需求比较典型。
- 复杂模板导出：文件里不光是数据，还包含固定格式的合同条款、审批流程、签名区域，数据只是填到指定位置。这类需求最麻烦，一般会先用Excel做好模板，再通过程序往模板里填数据。
清楚了需求类型，再选实现路线。CSV方案适合第一类，PhpSpreadsheet方案适合前两类，模板填充方案适合第三类。
1.2 主流PHP导出方案的横向对比
| 方案 | 优点 | 缺点 | 适合场景 |
|---|---|---|---|
| 原生CSV导出 | 实现简单、速度快、内存占用极低 | 格式能力几乎为零，中文环境要注意编码问题 | 纯数据导出，几万到几十万行都没压力 |
| PhpSpreadsheet导出 | 功能全，支持样式、多Sheet、公式、图表 | 大数据量下内存占用高，需要额外调优 | 万行以内带格式的导出 |
| PhpSpreadsheet + 临时文件 | 在完整功能基础上做了内存优化 | 需要写磁盘，稍微麻烦一点 | 几万行以上的大文件导出 |
| CSV + 前端转为Excel | 前端拿到CSV后用SheetJS等库解析导出 | 样式依然受限，交互链路变长 | 前后端分离项目中前端主导的场景 |
| 模板填充导出 | 样式完全可控，无需代码维护样式 | 模板需要人工维护，模板与数据结构的匹配逻辑较死板 | 合同、工资条、对账单等固定格式报表 |
从这张表能看出来，大部分项目的导出需求都能落到前两行。接下来的正文部分，我会重点讲PhpSpreadsheet的完整实现流程，因为这是功能最全、项目里用得最多的一条路线；CSV方案虽然简单，但也有不少细节值得讲，我会单独开一节。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 快速上手PhpSpreadsheet：环境准备与第一个导出脚本
PhpSpreadsheet是目前PHP社区里最主流的Excel操作类库，前身是PHPExcel。PHPExcel已经停止维护很久了，新的项目一律用PhpSpreadsheet。它能读写xlsx、xls、ods、csv等格式，支持样式、公式、图表、图片，功能非常全面。
2.1 环境要求与Composer安装
PhpSpreadsheet要求PHP 7.2及以上版本，如果你用的是PHP 8.0、8.1、8.2，完全没问题。还需要开启php_zip、php_xml、php_gd这几个扩展，其中zip用于读写xlsx压缩包，xml用于解析文件结构，gd用于处理图片。安装方式很简单，项目根目录下执行：
bash复制composer require phpoffice/phpspreadsheet
如果Composer安装速度慢，可以把源切换到国内镜像：
bash复制composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
安装完成后，在一个独立测试脚本里先确认环境没问题：
php复制<?php
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('A1', 'Hello World');
$writer = new Xlsx($spreadsheet);
$writer->save('test.xlsx');
echo 'OK';
运行后如果生成了一个test.xlsx文件，说明环境和类库都没有问题。这里要提醒一句：很多人把Composer安装和引入搞混，直接把类库文件拷到项目里用，这种做法极度不推荐，Composer的自动加载机制能让依赖管理省心很多，后续升级类库版本也是一个命令的事。
2.2 一个最小的导出脚本：从写入数据到浏览器下载
第一个正式脚本我们就做一件事：从数据库查询订单数据，导出成一个带表头的xlsx文件。为了不把篇幅浪费在数据库连接上，我用数组模拟数据源，你替换成实际查询语句即可。
php复制<?php
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
// 模拟从数据库查出的数据
$orders = [
['单号' => 'ORD20250601-001', '客户' => '张三', '金额' => 1280.50, '下单时间' => '2025-06-01 10:23:11'],
['单号' => 'ORD20250601-002', '客户' => '李四',