悠悠楠杉
网站页面
实际项目中，原始JSON字段名往往不符合业务展示需求。比如后端返回的字段可能是英文或缩写形式，但最终用户希望看到中文标题。这时可以通过配置fields
11/23
![]()
实际项目中，原始 JSON 字段名往往不符合业务展示需求。比如后端返回的字段可能是英文或缩写形式，但最终用户希望看到中文标题。这时可以通过配置 fields 和 fieldNames 实现自定义列名：
javascript
const fields = ['name', 'age', 'city'];
const fieldNames = ['姓名', '年龄', '城市'];
const parser = new Parser({ fields, fieldNames });
const csv = parser.parse(data);
这样生成的 CSV 文件第一行将显示“姓名,年龄,城市”，提升了可读性，也便于后续在 Excel 或 BI 工具中直接使用。
处理嵌套与数组结构
真实世界的数据通常包含嵌套对象或数组。例如：
javascript
const complexData = [{
user: { name: '王五', info: { job: '工程师' } },
tags: ['前端', 'Node.js']
}];
默认情况下，@json2csv/node 会自动将嵌套路径展开为 user.name、user.info.job 等形式。对于数组，则会将其合并为字符串（如 "前端,Node.js"），避免破坏表格结构。你也可以通过设置 flatten 和 delimiter 控制具体行为：
javascript
const parser = new Parser({
flatten: true,
delimiter: '|'
});
这使得即使面对复杂的树状结构，也能保持输出的整洁与一致性。
流式处理提升性能
当面对成千上万条记录时，一次性加载所有数据可能导致内存溢出。为此，@json2csv/node 提供了基于 Node.js Stream 的流式处理能力：
javascript
const { Transform } = require('stream');
const { createWriteStream } = require('fs');
const { Parser } = require('@json2csv/node');
const writeStream = createWriteStream('output.csv');
const transform = new Transform({ objectMode: true, transform: (chunk, enc, cb) => cb(null, chunk) });
const parser = new Parser({ fields: ['姓名', '年龄'] }, { readableObjectMode: false });
transform.pipe(parser).pipe(writeStream);
// 模拟逐条写入
data.forEach(item => transform.write(item));
transform.end();
这种方式能显著降低内存占用，特别适合大数据量的后台批处理任务。
结合 Express 实现动态导出
在 Web 应用中，常需根据用户请求实时导出数据。结合 Express 框架，可以轻松构建一个 CSV 下载接口：
javascript
app.get('/export', (req, res) => {
const data = getDataFromDB(); // 假设这是从数据库获取的数据
const parser = new Parser();
const csv = parser.parse(data);
res.header('Content-Type', 'text/csv; charset=utf-8');
res.attachment('users.csv');
res.send(csv);
});
注意设置正确的字符编码，防止中文乱码问题。必要时可在 CSV 开头添加 BOM 头 \ufeff，确保 Excel 正确识别 UTF-8 编码。
总结：选择合适的工具事半功倍
@json2csv/node 凭借其简洁的 API、强大的功能扩展性和良好的性能表现，已成为 Node.js 环境下进行 JSON 转 CSV 的首选方案。无论是简单的一维数据导出，还是复杂的多层结构处理，它都能提供稳定可靠的解决方案。合理利用其特性，不仅能提高开发效率，更能保障数据流转过程中的准确性与完整性。
