讲师中心 微信公众号
AI工具推荐 视频效率加速

Layui数据表格导出Excel时如何自定义列名

胖伟君_2629

胖伟君_2629

发布时间:2026-07-20 09:32:19

|

253人浏览过

|

来源于php中文网

原创

直接改cols配置里的title字段即可,Layui导出完全以title为准,与field值无关;初始化时须为每列显式设置title,漏设会导致表头为空。

导出表头名称和字段名不一致怎么办

直接改 cols 配置里的 title 字段就行。layui 导出 excel 完全以列定义中的 title 为准,和 field 值无关。比如后端返回字段是 user_name,但你想导出成“姓名”,就写 {field: 'user_name', title: '姓名'}。

常见错误现象:导出表头是 create_time、status_code 这类下划线命名,看着像数据库字段;或者英文字段直接裸奔上表头。

  • 初始化表格时,每列必须显式设置 title,不能留空或依赖默认值
  • 动态拼接 cols(比如从接口拉取列配置)时,确保每个对象都带 title,漏掉会导致该列表头为空
  • 如果某列用了 templet 渲染状态码为“启用/禁用”,导出时不会自动执行它——title 仍生效,但数据值还是原始码,需手动转换

想导出隐藏列或新增虚拟列怎么配表头

Layui 默认只导出 hide: false 的列,且顺序严格按 cols 数组顺序。要突破这个限制,就得临时构造一份新 cols 并传给 exportFile()。

例如:界面上没展示「创建人姓名」,但运营要求导出;或者需要加一列「导出时间」作为水印。

  • 先用 layui.table.config['yourTableId'].cols[0] 拿到当前列配置副本,再 push 一个新列对象:{field: 'export_time', title: '导出时间'}
  • 新列的 field 可以是任意字符串,只要在导出前把对应数据塞进每行数据里(如 row.export_time = new Date().toLocaleString())
  • 不要直接修改原始 cols 配置,否则会影响表格渲染
  • Layui 2.8+ 支持传入自定义 cols 和 data 给 exportFile();老版本只能用 table.exportFile('id', data, cols) 形式

用 exportFile() 手动传参时表头错位或全空

调用 table.exportFile() 时不传表格 ID,改用 data + headers 组合,才能完全绕过自动列提取逻辑。这时 headers 数组长度必须和每行数据长度严格一致,否则 Excel 列数对不上。

Hotnews Excel
Hotnews Excel

当用户发送热点新闻Excel文件时,自动执行相应操作。触发词:skill, 优化, 数据, data。

下载

典型错误:传了 headers: ['姓名', '邮箱'],但 data 每行是 ['张三', 'zhang@x.com', '2026-07-01'] —— 多出一列,Excel 第三列就会错位或空白。

  • data 必须是二维数组(如 [['张三','zhang@x.com'], ['李四','li@x.com']]),不能是对象数组(如 [{username:'张三'},...])
  • headers 必须和 data 每行字段顺序、数量完全对应,少一个或多一个都会导致错列
  • 如果表格启用了分页,table.cache['id'] 只含当前页数据;要导出全部,得配合后端重新拉取或用全量缓存
  • 注意 table.cache 是原始值,不含 templet 格式化结果(如状态码转文字),需自行映射

导出文件名带中文或日期后缀总失效

filename 参数必须在 table.exportFile() 调用时通过配置对象传入,且不能带扩展名。Layui 会自动加 .xlsx 或 .csv,传 "用户报表.xlsx" 会导致下载成 用户报表.xlsx.xlsx。

更麻烦的是:CSV 中文文件名在 IE/旧版 Edge 下大概率乱码,这不是前端编码问题,而是浏览器对 Content-Disposition 的 UTF-8 支持不一致。

  • 推荐用 Blob + URL.createObjectURL 替代默认下载,完全绕过 exportFile() 的参数限制
  • 构造 Blob 时务必加 BOM 头:'\uFEFF' + csvString,否则 Excel 打开会乱码
  • 文件名可放心用中文,如 a.download = '订单汇总-20260701.csv'
  • 如果坚持用 exportFile(),filename 只写 "订单汇总-20260701",别加后缀
实际中最容易被忽略的点是:**headers 和 data 的字段顺序必须人工对齐,Layui 不做任何校验或容错**。哪怕只是多了一个空格、少了一个引号,导出的 Excel 就可能列错位、值为空,而且没有任何报错提示。

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

更多
ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2880

2023.06.14

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

360

2023.08.31

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2693

2023.11.15

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1161

2024.09.24

excel对比两列数据异同
excel对比两列数据异同

Excel作为数据的小型载体,在日常工作中经常会遇到需要核对两列数据的情况,本专题为大家提供excel对比两列数据异同相关的文章,大家可以免费体验。

5281

2023.07.25

excel重复项筛选标色
excel重复项筛选标色

excel的重复项筛选标色功能使我们能够快速找到和处理数据中的重复值。本专题为大家提供excel重复项筛选标色的相关的文章、下载、课程内容,供大家免费下载体验。

3276

2023.07.31

excel复制表格怎么复制出来和原来一样大
excel复制表格怎么复制出来和原来一样大

本专题为大家带来excel复制表格怎么复制出来和原来一样大相关文章,帮助大家解决问题。

3060

2023.08.02

excel表格斜线一分为二
excel表格斜线一分为二

在Excel表格中,我们可以使用斜线将单元格一分为二。本专题为大家带来excel表格斜线一分为二怎么弄的相关文章,希望可以帮到大家。

1444

2023.08.02

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 44.4万人学习

成为PHP架构师-自制PHP框架
成为PHP架构师-自制PHP框架

共28课时 | 3.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn