用途:在 JSON、CSV 及其他格式之间转换数据,支持过滤、映射、扁平化嵌套对象和重塑数据结构,用于分析、报表和 API 集成。适用场景包括:JSON 与 CSV 互转、提取或转换特定字段、将嵌套 JSON 扁平化为表格、处理 API 响应。
主要能力:json_to_csv(JSON 数组转 CSV,可用 jq 的 @csv 或 csvkit 的 in2csv -f json);csv_to_json(用 csvjson 或 jq 转换);filter_and_extract_json(用 jq select 按条件过滤并提取字段,支持嵌套字段);flatten_nested_json(将嵌套对象扁平化为点号分隔键);transform_csv_data(用 csvcut、csvgrep、csvsort、csvjoin 选择列、过滤、排序、合并);aggregate_and_group_json(用 jq group_by 实现类似 SQL GROUP BY 的分组计数、求和、平均)。
必要工具:jq(命令行 JSON 处理器)、csvkit(CSV 工具集),无需外部 API。安装:Ubuntu/Debian 执行 sudo apt-get install -y jq csvkit;macOS 执行 brew install jq csvkit;Node.js 基础操作原生支持,高级 CSV 解析可 npm install csv-parse csv-stringify。
限制与最佳实践:大文件建议用 jq -c 流式逐行处理,超过 100MB 使用流式解析器;转换前校验 JSON/CSV 格式;处理缺失字段用默认值;注意 CSV 会把所有值转为字符串,JSON 保留类型;确保 UTF-8 编码并正确转义引号。常见问题包括 jq 解析错误、CSV 列错位、特殊字符乱码、大文件内存不足等,需先校验格式、检查转义、使用流式模式,嵌套对象应先扁平化再转 CSV。