转换前先识别数据形状
CSV 是表格：由行和列构成，每个单元格以文本表示。JSON 可以表示对象、数组、数字、布尔值、null 和嵌套结构。YAML 同样是结构化数据，但通过缩进和标量语法以更适合人工编辑的方式表达这些概念。转换改变的是表示形式，不会替你判断数值真正代表什么。
请从有代表性、已脱敏的小样本开始。样本应包含带引号字段、空值、含分隔符的值、像 `00123` 这样的数字型编号，以及预期的嵌套配置。转换完整导出或替换配置文件前，先逐项比较输入与输出。
转换 CSV 到 JSON 时注意表头和分隔符
CSV 转 JSON 完全在浏览器本地运行，输入最多 2 MB。请选择真实分隔符：逗号、分号、Tab 或竖线。即使分隔符错误，结果也可能可以解析但只生成一个很长的列，因此要检查输出键名和行数，而不能只看是否报错。
启用“首行为表头”后，CSV 第一行会成为 JSON 属性名。当空白记录不应成为数据行时启用“跳过空行”。转换器会有意将单元格保留为文本，例如 `true`、`42`、`00123` 都仍是字符串。这避免悄悄改变编号或展示值；但目标应用需要类型时，仍应按其 Schema 在后续步骤中转换。
只有真正表格化的 JSON 才应转换为 CSV
JSON 转 CSV 支持一个对象或对象数组，并收集所有行中出现的顶层字段作为列。这适合扁平的 API 结果、库存或联系人列表。它不会自动把嵌套对象和数组变成有统一含义的表格；导出前应决定是展平、序列化、展开为多行还是忽略这些字段。
当每个对象应成为一条 CSV 行时，请使用 JSON 数组。检查结果中的列名、含逗号或换行的值、空单元格及字段顺序。工具会处理标准 CSV 引号，但电子表格软件打开 CSV 时可能自行猜测类型，例如改写长编号、日期或前导零；这些区分重要时，应按文本列导入。
选择有代表性样本。
包含表头、空值、带引号文本、前导零和特殊字符。
选择真实分隔符和表头行为。
不要因为习惯就假设是逗号分隔，其他地区导出的文件可能不同。
检查转换后的结构。
比较行数、键名、编号与字段。
按目标验证。
使用应用 Schema 检查；重要值不应自动转换时，按文本导入电子表格。
在 YAML 和 JSON 间转换时不要混淆“有效”与“符合意图”
YAML 转 JSON 和 JSON 转 YAML 同样在浏览器本地运行，输入上限为 2 MB。可选择 2 或 4 空格缩进，也可递归排序键。排序能让 diff 更稳定，但也可能改变配置面向人的阅读顺序，只有需要稳定排序时才应使用。
解析成功只表示文本符合格式解析器，不代表应用一定接受。请检查看起来像布尔或数字的字符串、null、引号、数组和嵌套键，然后使用 JSON Toolkit 或应用自身验证器按需要的 Schema 和业务规则检查。
有意识地对待本地处理和数据
两个转换器均直接在浏览器中运行。输入文本、输出、剪贴板复制和 data URL 下载都不会上传到 MV Tools。这很适合普通配置和表格处理，但仍需要最小化敏感数据并遵守组织的数据处理要求。
除非当前浏览器环境已获授权，不要粘贴生产密钥、个人数据、访问令牌、完整客户导出或凭据。排错时优先使用小型脱敏样本，并按正常存储控制保留源数据和已核对的转换副本。
常见问题
为什么 CSV 中的 true 或 00123 在 JSON 中仍保留为字符串？
转换器将 CSV 单元格保留为文本而不是猜测类型，这能保护编号和展示值；类型应在后续按目标 Schema 的规则转换。
嵌套 JSON 可以直接转换成有用的 CSV 吗？
不能自动完成。工具使用对象或对象数组的顶层字段；嵌套数据应由你决定如何展平、序列化、展开或忽略。
YAML 或 JSON 有效是否表示配置一定可用？
不表示。它只说明文本可以解析，应用仍需进行 Schema、环境和业务规则验证。