在浏览器中转换 CSV 和 JSON 时，文件内容可以留在设备上。如果应用在本地读取、分析、转换并下载全部内容，就会发生这种情况。这种设计可以减少数据传输，但不会自动使所有页面、扩展、设备或输入安全。
快速回答： 使用明确说明浏览器本地处理的转换器。对于非常敏感且非必要的工作，如果应用可以离线运行，请断开网络。检查分隔符、标题、编码、数据类型、公式和行数。删除源文件前，请验证 JSON 输出。
本指南解释 CSV 和 JSON 的差异、“在浏览器中私密处理”的含义，以及如何验证转换。内容关联CSV 到 JSON 转换器、JSON 工具和 CSV 与 XML 数据工具。
不上传文件也可以将 CSV 转换为 JSON 吗？
可以。现代浏览器允许页面读取用户选择的文件。JavaScript 可以在内存中分析文件，并创建下载，而不将内容发送到应用服务器。
W3C File API 规定浏览器访问选定文件和二进制数据的方式。本地转换可以使用文件输入、FileReader、Blob、对象 URL 和下载操作。除非页面已经可以离线运行，否则浏览器仍会从某处加载应用代码。
直接回答： “在浏览器中运行”描述主要转换发生的位置。它单独不能证明没有代码发送数据。如果数据敏感，请检查产品说明、网络行为、代码控制、扩展和设备策略。
如果代码决定这样做，应用可以发送遥测、错误详情或内容。受损依赖也可以改变行为。扩展可能拥有广泛的页面访问权限。受管理设备、杀毒软件、同步文件夹、剪贴板管理器和系统备份会创建独立的数据路径。
对于普通结构化数据，本地转换可以通过移除例行服务器传输显著改善隐私。对于受监管数据集、秘密或高影响数据，请遵循组织批准的工具和数据处理策略。
CSV 和 JSON 有什么区别？
CSV 使用文本字段和分隔符表示表格记录。JSON 使用对象、数组、字符串、数字、布尔值和 null 表示值。转换需要作出决定，因为两种格式不会保存相同结构或相同类型。
| 特征 | CSV | JSON | 转换决定 |
|---|---|---|---|
| 主要结构 | 行和字段 | 嵌套对象和数组 | 选择每行一个对象或其他模式 |
| 字段名 | 通常是第一行 | 对象的成员名 | 决定第一行是否为标题 |
| 类型 | 分析时通常是文本 | 字符串、数字、布尔值和 null |
保留文本或推导类型 |
| 嵌套 | 没有通用的嵌套模型 | 原生嵌套 | 展平或序列化嵌套值 |
| 缺失数据 | 空字段或缺失列 | 缺失成员、空字符串或 null |
定义策略 |
| 分隔符 | 逗号、制表符、分号或其他 | 语法使用标点 | 识别或选择 CSV 分隔符 |
| 字符编码 | 需要外部约定 | 交换时通常为 UTF-8 | 正确解码源数据 |
| 记录顺序 | 行顺序 | 数组顺序保持不变 | 有意保留或排序 |
RFC 4180 记录常见 CSV 格式及其 MIME 类型。该标准描述逗号分隔的记录、可选标题、双引号和转义引号。真实文件可能使用制表符、分号、其他行尾或特殊约定。
RFC 8259 定义 JSON 数据交换格式。JSON 文本包含序列化值。对象使用名称和值。数组使用有序值。JSON 语法不允许注释、尾随逗号、NaN 或 Infinity。
转换可能丢失什么？
转换可能丢失类型意图、前导零、精度、重复标题、嵌套结构、公式语义和原始格式。正确分析不表示输出保留业务含义。
考虑包含 00123 的 CSV 字段。它可能是邮政编码、标识符或数字。将它转换为 JSON 数字 123 时，前导零会丢失。1E10 可能是看起来像科学计数法的标识符。长账号可能超过消费者的精确数字范围。
日期值有类似风险。01/02/03 在每个国家不一定表示同一日期。转换器不应静默猜测。如果模式没有规定格式，请将有歧义的值保留为字符串。
空值也需要策略。空 CSV 字段可能变为 ""、null 或缺失成员。这些输出不等价。空字符串可以表示已知的空值。null 可以表示没有值。缺失成员可以表示“未知”或“不适用”。
重复标题会产生无效或有损的对象映射。如果一行包含两个名为 status 的列，普通 JSON 对象无法可靠地在相同名称下保留两个值。请重命名列、拒绝文件，或将行映射为带有单独标题列表的数组。
转换器应该推导数据类型吗？
类型推导可以生成方便的 JSON，但会增加风险。字符串 true 可能是回答，也可能是字面标签。0007 可能是标识符。空格可能表示缺失数据，也可能是有意的空值。
尽可能使用模式驱动的类型。将每列定义为字符串、整数、小数、布尔值、日期、时间戳或可空值。请拒绝无效输入，不要猜测。如果转换有业务影响，请保留原始文本供检查。
没有模式时，保留字符串是最安全的默认设置。它保留词法内容和前导零。后续经过验证的流程可以转换选定字段。
对于数字值，请决定如何处理小数精度。JavaScript 浮点数不能精确表示所有小数和大整数。财务数据和标识符通常需要小数库、整数字符串或任意精度类型。
W3C 表格数据模型描述了使用元数据和类型标注表格的更完整方法。简单转换器可能不实现 CSVW 元数据。该模型说明模式上下文的重要性。
字符编码应如何工作？
系统之间交换的 JSON 使用 Unicode，通常使用 UTF-8。CSV 文件可能使用 UTF-8、UTF-16、Windows 代码页或其他旧编码。使用错误解码器读取字节会生成替换字符或改变文本。
WHATWG 编码标准规定浏览器标签和解码行为。它统一 Web 使用的旧编码处理方式，也说明错误模式和替换行为。
新导出请使用 UTF-8。RFC 3629 定义 UTF-8为 Unicode 转换格式。UTF-8 CSV 文件中可能出现字节顺序标记，尽管 UTF-8 不需要它。如果解析器不移除标记，一些解析器会将其保留为第一标题的一部分。
转换前检查带重音的名称、非拉丁字母、Emoji、货币符号和排版标点。之后比较有代表性的值。相同行数不能识别损坏的字符。
如果编码未知，请询问创建者，或使用受控识别。自动识别具有概率性。对于短文件或几乎全是 ASCII 的文件，它可能产生合理但错误的结果。
分隔符和引号如何工作？
字段中的逗号通常需要双引号。带引号字段中的双引号通常使用另一个双引号转义。带引号字段可以包含换行。将每行按逗号拆分的解析器会在这些有效情况中失败。
以下记录包含三个字段，尽管它包含额外逗号：
42,"Mumbai, Maharashtra","Approved"
以下记录在第二个字段中包含引号：
43,"The value is ""ready""","Approved"
请使用经过检查、支持配置分隔符、引号、转义、标题和行尾的 CSV 解析器。对于任意 CSV，不要使用简单正则表达式。
一些国家使用分号，因为逗号是小数分隔符。制表符分隔数据可以使用 .tsv。转换器可以识别候选项，但必须显示所选分隔符，并允许用户修正。
什么是 CSV 公式注入？
电子表格程序可能将以特定字符开头的单元格解释为公式。如果攻击者控制字段，打开导出的 CSV 可能触发公式或外部操作。行为取决于应用和用户决定。
OWASP CSV 注入指南说明，以 =、+、- 或 @ 开头的单元格可能被解释为公式。分隔符和换行也可能使受控数据开始新单元格。
CSV 转 JSON 不会执行电子表格公式。但是，稍后将 JSON 导出为 CSV 可能重新生成危险单元格。将公式形式文本视为不可信输入。对目标电子表格应用适当的输出策略，并保留数据含义。
转义策略有缺点。在一些应用中，前置撇号可以阻止公式。它也会改变存储文本，并可能在其他消费者中可见。将字段放入引号并不总是足够。电子表格可能在 CSV 分析后评估内容。请遵循目标应用当前的安全指导。
不要只为检查而在电子表格中打开未知 CSV。请使用面向文本的解析器和预览。根据组织策略限制外部链接和活动内容。
浏览器中的私密处理需要什么？
可靠的本地流程需要明确边界。转换必须在本地读取所选文件，避免上传内容，在本地生成输出，并说明遥测。应用必须使用限制性安全策略和维护良好的依赖。
用户也有责任：
- 使用可靠设备和兼容浏览器。
- 移除不必要访问页面的扩展。
- 确认网站来源和传输安全。
- 处理敏感数据集时，不使用共享或公共设备。
- 保持系统和浏览器更新。
- 将下载结果保存到受批准的位置。
- 根据策略删除临时副本。
只有当页面已经拥有所需完整代码时，断开网络才会增加安全性。它不会移除已经加载的恶意代码。它也不能防止本地恶意软件、扩展、屏幕截图、同步文件夹或之后的网络访问。
开发者工具可以在测试期间显示请求。观察不是正式保证。请求可能取决于文件类型、错误、时间、配置或更新。独立检查、可复现构建、安全控制和组织批准可以提供更强证据。
CSV 到 JSON 的安全流程
请对受控转换使用以下流程：
- 将源文件复制到受保护的工作位置。
- 可以选择记录名称、大小和可靠哈希。
- 确认预期编码和分隔符。
- 决定第一行是否包含标题。
- 检查重复、空和意外标题。
- 选择保留字符串或遵循模式的策略。
- 在完整转换前预览有代表性的行。
- 使用 CSV 到 JSON 工具转换。
- 验证生成的 JSON 语法。
- 比较行数和重要字段。
- 将结果保存到受批准的位置。
- 根据保留规则保留或删除源文件。
预览必须包含首行和末行、带引号记录、多行字段、非 ASCII 字符、空值和最大长度值。随机样本有助于处理大型数据集。定向边界用例可以提供更好覆盖。
如何验证 JSON 输出？
从语法开始。JSON Validator（英文页面）可以查找无效 JSON。语法验证确认语法，不确认预期字段、类型、范围或关系。
然后验证结构。JSON 或应用模式可能要求名称、类型、格式、边界和嵌套。检查每行都成为数组元素。确认分析错误没有丢失记录。
请使用 JSON Formatter进行可读检查。格式化会改变空白，但不会改变数据含义。不要从美观的缩进推导正确性。
如果拥有可靠样本，请使用 JSON Comparator（英文页面）比较预期和实际输出。决定成员顺序、数组顺序、数字写法和缺失成员是否重要。
验证必须包含：
| 检查 | 建议证据 |
|---|---|
| 行保留 | 源行数等于 JSON 长度 |
| 标题映射 | 预期键存在，重复项已处理 |
| 字符完整性 | 有代表性的 Unicode 值一致 |
| 类型保留 | 标识符保留前导零和长数字 |
| 缺失值 | 空、null 和缺失遵循策略 |
| 多行字段 | 换行保留在一个值中 |
| 公式形式文本 | 策略记录潜在活动单元格 |
| 文件完整性 | 可选哈希标识已检查的源文件 |
重要迁移请创建自动断言。验证数量、必需键、唯一标识符、总和、最小和最大日期以及已知记录。将聚合值与源系统比较。
JSON 到 CSV 的安全流程
反向转换需要表格形式。由扁平对象组成的 JSON 数组可以自然映射到行。嵌套对象和数组需要展平策略。
你可以使用点连接路径，例如 address.city。你可以将嵌套值序列化为 JSON 文本。你可以创建多个相关 CSV 文件。每项决定都会影响重新导入和人工编辑。
请选择稳定的列顺序。决定如何表示缺失成员。根据所选 CSV 规则为字段添加引号。使用电子表格前应用防止公式注入的策略。导出 UTF-8，并说明是否存在字节顺序标记。
不要假设所有成员都出现在第一项中。检查允许的模式或所有记录。否则，后续字段可能丢失。对于非常大的文件，请使用模式传输行，不要先加载所有对象。
大型文件的性能和内存
浏览器内存有限。读取数 GB 文件、将其分析为对象，并序列化另一份完整副本，可能需要文件大小的数倍。页面可能无响应，进程也可能终止。
可扩展转换器可以读取流或区块，增量分析记录，并逐步写入输出。带换行的带引号字段会使区块边界变复杂。解析器必须在区块之间保留状态。
文件超过限制时，请使用桌面工具、经过检查的命令行流程或受控服务器流程。“不上传”不要求使用浏览器。本地脚本同样可以让数据留在设备上，并支持流处理和更好的检查控制。
请使用有代表性且不敏感的文件测试性能。监控内存和输出大小。在界面中定义最大输入大小。不要因为文件选择对话框接受所有文件，就承诺支持所有文件。
常见转换错误
错误 1：在逗号处拆分行
带引号的逗号和多行字段会使简单拆分无效。请使用 CSV 解析器。
错误 2：推导所有看起来像数字的字段
标识符、邮政编码、账户引用和电话号码可能丢失零或精度。除非模式另有规定，否则保留字符串。
错误 3：假设第一行是标题
有些文件没有标题。其他文件在表格前包含标题行。请预览并明确选择标题。
错误 4：忽略重复标题
JSON 对象无法可靠地在同一名称下保存两个值。请拒绝重复项，或根据有文档的规则重命名。
错误 5：仅因本地处理就声称完全隐私
本地处理会减少例行传输，但不能保护受损设备、浏览器、扩展、依赖或存储位置。
错误 6：只验证 JSON 语法
有效 JSON 仍可能包含错误行、损坏文本、改变的标识符或错误类型。请验证业务模式并比较源数据。
错误 7：在电子表格中打开不可信输出
公式形式字段可能在电子表格应用中变为活动内容。请使用安全导出策略并检查目标环境。
什么时候应避免在线工具？
如果文件包含凭据、加密密钥、医疗数据、受监管金融数据、未发布业务信息、私人客户数据集或其他受限内容，请避免使用未经批准的公共工具。请使用组织批准的环境。
如果转换必须可重复，也请避免一次性的交互式转换。经过检查的脚本、版本化代码、测试、日志和哈希可以提供更强的迁移证据。
公共浏览器工具更适合非敏感数据、样本、学习、诊断和文档边界内的透明转换。诊断结构时，请使用合成示例替代真实数据集。
常见问题
浏览器中的 CSV 转换器会上传我的文件吗？
不一定。浏览器可以在本地读取并转换所选文件。请检查具体应用的说明和行为。不要假设所有转换器都以相同方式运行。
浏览器处理完全私密吗？
没有任何功能可以证明完全隐私。本地处理会减少服务器传输。设备安全、扩展、加载代码、遥测、下载、复制和策略同样重要。
CSV 数字必须转换为 JSON 数字吗？
只有模式将其识别为数字，并且消费者可以保留其范围和精度时，才需要转换。请将标识符和有歧义的值保留为字符串。
空 CSV 字段应如何转换？
请选择有文档的策略。空字符串、null 和缺失成员表示不同含义。始终使用同一规则。
CSV 可以在字段中包含换行吗？
可以。常见 CSV 规则允许带引号字段包含换行。兼容解析器必须将它们作为记录中单个字段的一部分处理。
为什么我的第一个 JSON 键包含奇怪字符？
CSV 文件可能以字节顺序标记开头，解析器将其保留在第一标题中。请使用正确解码器，并在适当时移除标记。
格式化 JSON 比紧凑 JSON 更有效吗？
不是。字符串外的空白不会改变 JSON 值。两种形式都可能有效。请使用验证器检查语法，并使用模式检查含义。
可以将嵌套 JSON 文档转换为 CSV 吗？
可以，但需要展平策略。嵌套数组可能生成重复行、序列化单元格或独立关系表。请记录决定。
隐私和验证的最终规则
本地转换可以移除例行传输，并让普通处理留在设备上。请将此设计视为隐私控制，不要将其视为完整安全保证。
请定义 CSV 方言、编码、标题规则、类型策略、空值策略和输出模式。然后验证语法、数量、Unicode、标识符、边界情况和公式形式字段。在结果通过这些检查前保留源文件。