常见问题
关于 JSON 转 CSV 转换器的常见问题与解答。
一般问题
什么是 JSON 转 CSV 转换器？
JSON 转 CSV 转换器是一款基于网页的工具，可将 JSON（JavaScript Object Notation）数据转换为 CSV（Comma-Separated Values，逗号分隔值）格式。它适用于数据分析、报表导出，以及与表格类应用的集成。
我的数据安全吗？
安全。所有处理都在你的浏览器本地完成，不会把数据发送到外部服务器。你的信息不会离开你的设备。
需要安装吗？
不需要安装。该工具完全运行在浏览器中，适用于任何可联网的现代设备。
这款工具免费吗？
是的，JSON 转 CSV 转换器完全免费使用，没有任何限制。
技术问题
支持哪些浏览器？
工具可在所有现代浏览器中使用：
- Chrome 60+
- Firefox 55+
- Safari 12+
- Edge 79+
最大能处理多大的文件？
没有硬性上限，但性能取决于设备内存。一般来说：
- 小文件（< 1MB）：即时处理
- 中等文件（1-10MB）：快速处理
- 大文件（> 10MB）：可能需要几秒钟
可以处理嵌套的 JSON 对象吗？
可以。工具会使用点号（dot notation）自动扁平化嵌套对象。例如：
{ "user": { "name": "John", "age": 30 } }
会变为：
user.name,user.age
John,30
数组如何处理？
对象中的数组会被转换为 JSON 字符串，以保留其结构：
{ "tags": ["red", "blue", "green"] }
会变为：
tags
"[""red"",""blue"",""green""]"
数据格式问题
支持哪些 JSON 格式？
工具支持：
- 对象数组：
[{"name": "John"}, {"name": "Jane"}] - 单个对象：
{"name": "John", "age": 30} - 嵌套对象：自动扁平化
- 混合数据类型：数字、字符串、布尔值、null
可以生成哪些 CSV 格式？
你可以生成：
- 标准 CSV（逗号分隔）
- 欧式 CSV（分号分隔）
- 制表符分隔（TSV）
- 管道符分隔
- 自定义分隔符格式
特殊字符如何处理？
特殊字符会被正确转义：
- 引号：
"Hello"会变为""Hello"" - 逗号：
Smith, John会变为"Smith, John" - 换行：会保留并进行正确转义
国际字符呢？
工具通过 UTF-8 编码支持所有 Unicode 字符：
- Chinese: 中文
- Japanese: 日本語
- Arabic: العربية
- Emojis: 🚀 📊 ✅
使用问题
如何包含列标题？
在转换设置中启用 “Include Headers” 选项即可。它会添加第一行作为列名。
可以自定义分隔符吗？
可以，可从以下选项中选择：
- Comma (,) - Standard CSV
- Semicolon (;) - European format
- Tab - TSV format
- Pipe (|) - Custom format
空值如何处理？
空值或 null 会在 CSV 输出中转换为空字符串。你也可以在转换选项中自定义该行为。
可以保存转换历史吗？
可以。工具会在浏览器本地自动保存最近 50 次转换记录。你可以加载之前的转换，或清空历史记录。
错误处理
如果我的 JSON 无效怎么办？
工具会高亮错误并提示类似 “Invalid JSON format. Please check your input.” 的信息。常见问题包括：
- 对象之间缺少逗号
- 方括号或花括号不匹配
- 引号未转义
- 末尾多余逗号
为什么我的 CSV 是空的？
通常是因为：
- JSON 输入为空
- JSON 只包含空数组或空对象
- 有校验错误导致无法转换
如何修复转换错误？
- 使用在线 JSON 校验工具验证你的 JSON
- 检查常见语法错误
- 确保对象结构一致
- 移除末尾多余逗号
性能问题
转换速度有多快？
转换速度取决于数据大小：
- 小数据集（< 100 条记录）：即时
- 中等数据集（100-1000 条记录）：< 1 秒
- 大数据集（> 1000 条记录）：1-5 秒
能处理非常大的文件吗？
可以，但建议注意：
- 浏览器内存限制
- 数据越大处理时间越长
- 对于特别大的文件，建议先拆分数据
支持离线使用吗？
支持。页面加载完成后，工具即可完全离线工作。转换过程中不需要联网。
集成问题
我能在自己的应用里使用吗？
该工具主要面向网页使用，但你也可以：
- 使用浏览器版本进行手动转换
- 在你的应用中实现类似逻辑
- 使用提供的代码示例进行集成
如何把 CSV 导入 Excel？
- 将 JSON 转换为 CSV
- 复制 CSV 数据
- 打开 Excel
- 粘贴数据
- 如有需要，使用 “Text to Columns”
可以用于 Google Sheets 吗？
可以。生成的 CSV 与 Google Sheets 兼容：
- 将 JSON 转换为 CSV
- 下载 CSV 文件
- 导入到 Google Sheets
- 或直接复制/粘贴
故障排查
工具在我的浏览器里无法使用
可以尝试：
- 将浏览器升级到最新版本
- 清理浏览器缓存与 Cookie
- 暂时禁用浏览器扩展
- 换用其他浏览器
我遇到了编码问题
对于国际字符：
- 使用 UTF-8 编码
- 确保你的 JSON 编码正确
- 检查目标应用是否支持 UTF-8
CSV 在 Excel 里看起来不对
可能原因：
- 分隔符设置（欧洲地区 Excel 建议使用分号）
- 编码问题（保存为 UTF-8）
- 引号转义问题
我的数据被截断了
请检查：
- 是否有超长文本字段
- 是否有导致问题的特殊字符
- 浏览器内存限制
- Excel 单元格字符上限（32,767 字符）
进阶问题
能把 CSV 再转换回 JSON 吗？
该工具仅支持 JSON 转 CSV。反向转换需要单独的 CSV 转 JSON 工具。
如何处理非常复杂的嵌套结构？
工具会自动扁平化嵌套对象。对于特别复杂的结构：
- 考虑先对 JSON 进行预处理
- 使用更专业的工具
- 手动重构数据
能自定义输出格式吗？
当前可用的自定义选项包括：
- 分隔符选择
- 编码选择
- 是否包含表头
- 引号转义
有 API 版本吗？
目前仅提供网页版。如需程序化使用，你可以参考提供的代码示例自行实现转换逻辑。
支持问题
我可以在哪里获得帮助？
- 查看文档各章节
- 查看示例
- 用样例数据测试
- 如仍有问题可联系支持
我可以建议新功能吗？
可以，我们欢迎功能建议。请尽量提供：
- 你需要的具体功能
- 你的使用场景
- 它将如何改善你的工作流
有移动端版本吗？
工具可在移动端浏览器使用，但为获得更佳体验：
- 大数据集建议横屏使用
- 复杂数据建议使用平板
- 初次加载页面时保持网络稳定