导出CSV中文乱码需加UTF-8 BOM头（\xEF\xBB\xBF）；大数据量须用Db::chunk分批导出防内存溢出；中文文件名要用rawurlencode()编码并兼容IE；第三方CSV扩展可能加重内存负担。

导出CSV时中文乱码怎么办

直接用 fputcsv 写入中文，Excel 打开大概率是乱码——本质是没加 UTF-8 BOM 头。ThinkPHP 自带的 response() 不会自动补 BOM，得手动塞。

实操建议：

• 在写入 CSV 内容前，先用 fputs($fp, "\xEF\xBB\xBF") 写入 BOM（$fp 是 fopen 返回的句柄）
• 别用 iconv('UTF-8', 'GBK', $str) 转码，Excel 识别 UTF-8+BOM 才稳定
• 如果用 Response::create()->contentType('text/csv')，记得在内容开头拼上 "\xEF\xBB\xBF"

用 Db::select() 导出大量数据内存爆掉

一次性查几万条再遍历写 CSV，PHP 进程内存很容易撑到 512MB+，尤其字段多或含长文本时。

实操建议：

• 改用 Db::chunk(500, function ($list) use ($fp) { ... }) 分批查、分批写
• 每批处理完调用 ob_flush() 和 flush()（配合 set_time_limit(0) 防超时）
• 避免在闭包里做额外查询或实例化对象，保持轻量
• 字段名和数据统一用 array_values() 提取，防止 fputcsv 写入关联键名导致格式错乱

导出文件名含中文浏览器下载失败

Chrome 和 Edge 对 Content-Disposition 中的中文文件名支持差，直接写 filename="用户列表.csv" 会导致下载名变成 download.csv 或报错。

Knowledge Graph - Csv Graph Loader Generator

从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。

下载

实操建议：

• 用 rawurlencode() 编码文件名，再套一层 mb_convert_encoding() 兼容旧版 IE：
  rawurlencode(mb_convert_encoding($name, 'UTF-8', 'auto'))
• 更稳妥的做法：服务端生成英文文件名（如 export_202405201423.csv），前端用 download 属性控制显示名：<a href="/export" download="用户列表.csv"></a>
• ThinkPHP 6.1+ 可用 Response::create()->header(['Content-Disposition' => 'attachment; filename*=UTF-8\'\'' . rawurlencode($name)])

用 think-csv 扩展反而更慢？

第三方扩展如 topthink/think-csv 封装了写入逻辑，但默认把全部数据加载进内存再一次性写，对大数据量反而比手写 fputcsv + chunk 更吃资源。

实操建议：

• 小数据量（
• 中大型项目不建议引入该扩展，它不支持流式写入，也不适配 TP8 的协程模型
• 真正要简化代码，不如自己封装一个轻量类，只做三件事：写 BOM、转义双引号、分块写入
• 注意 fputcsv 默认用 , 分隔、" 包裹字段，若业务要求制表符（\t）分隔，得用 fwrite 手动拼接

BOM 头、分块读取、文件名编码这三点，漏掉任意一个，线上导出就容易被用户截图发群里问“为什么打不开”——不是功能没做，是细节没压住。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！