在HTML中显示JSON数据的核心方法是利用JavaScript的JSON.stringify()将对象转换为字符串，并通过DOM操作将其插入页面元素，通常结合<pre>标签保持格式，或使用第三方库如json-viewer实现可视化展示。
前端开发中,数据交互是常态，JSON作为轻量级的数据交换格式，几乎统治了现代Web开发的数据层，当后端返回一串密密麻麻的JSON代码时，直接扔给前端页面往往是一团乱麻，开发者需要一种优雅、清晰且具备交互性的方式来呈现这些数据，这不仅是视觉问题，更是用户体验的关键环节。
基础方案：原生JavaScript实现JSON格式化
对于大多数常规场景,不需要引入庞大的第三方库，原生JavaScript提供的能力已经足够强大，关键在于如何正确解析并美化输出。
核心API与DOM操作路径
整个过程可以分为三个明确的步骤：获取数据、转换格式、渲染页面。
- 获取数据：通常通过
fetch或XMLHttpRequest从API获取JSON字符串。 - 转换格式：使用
JSON.parse()将字符串转为JavaScript对象，再使用JSON.stringify()将对象转回字符串，并启用格式化参数。 - 渲染页面：将格式化后的字符串插入到HTML容器中。
具体操作代码如下：
// 假设data是获取到的JSON字符串
const jsonData = '{"name": "张三", "age": 28, "skills": ["HTML", "CSS", "JS"]}';
// 第一步：解析为对象
const parsedData = JSON.parse(jsonData);
// 第二步：格式化为带缩进的字符串，第二个参数为null，第三个参数为缩进空格数（如2或4）
const formattedJson = JSON.stringify(parsedData, null, 4);
// 第三步：插入到ID为json-output的div中
document.getElementById('json-output').textContent = formattedJson;
这里有一个常见的陷阱：直接使用innerHTML插入格式化后的JSON字符串可能导致XSS攻击风险或HTML实体转义问题，推荐使用textContent或innerText，或者将内容包裹在<pre>标签中，以保留换行和空格。
使用
标签保持排版
<pre>标签是HTML中用于预格式化文本的标准元素，它告诉浏览器保留文本中的空格、换行和缩进，这对于JSON数据的展示至关重要，因为JSON的结构依赖于缩进来体现层级关系。
如果不使用<pre>，格式化后的JSON在页面上会变成一行长字符串，失去可读性，结合CSS，可以进一步美化<pre>标签，例如添加背景色、内边距和滚动条，使其看起来更像是一个代码编辑器。
进阶方案：可视化组件库的应用
当JSON数据变得非常庞大或复杂时,纯文本展示已经无法满足需求，用户需要折叠、展开、搜索甚至复制特定节点的功能，这时，引入专门的JSON可视化工具库是更优选择。
主流库对比与选型
业内专家指出,目前前端社区中流行的JSON可视化库主要有json-viewer、react-json-view（针对React生态）和vue-json-viewer（针对Vue生态），对于原生HTML/JS项目，json-viewer是一个轻量且功能丰富的选择。
| 特性维度 | 原生JS方案 | json-viewer库 | react-json-view |
|---|---|---|---|
| 依赖大小 | 0 KB | ~10 KB (gzip) | ~50 KB (gzip) |
| 交互功能 | 无 | 折叠/展开/搜索/复制 | 折叠/展开/编辑/复制 |
| 学习成本 | 低 | 中 | 高（需熟悉React） |
| 适用场景 | 简单调试、小数据量 | 中等复杂度、需交互 | 大型React应用 |
选择哪种方案取决于项目需求,如果只是为了在后台管理系统中查看日志，原生方案足够；如果需要给最终用户提供数据浏览功能，可视化工具库能显著提升体验。
集成步骤详解
以json-viewer为例，集成过程非常直观。
- 引入资源：通过CDN或npm安装库文件。
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/json-viewer@2.0.0/dist/json-viewer.bundle.css"> <script src="https://cdn.jsdelivr.net/npm/json-viewer@2.0.0/dist/json-viewer.bundle.js"></script>
- 创建容器：在HTML中放置一个空的
<div>。<div id="json-viewer"></div>
- 初始化组件：在JavaScript中调用库的构造函数。
const viewer = new JSONViewer(document.getElementById('json-viewer')); viewer.setValue(parsedData); // 传入解析后的对象
这种方式不仅代码简洁,而且自动处理了复杂的DOM操作和事件绑定，如点击节点折叠、右键复制等。
性能优化与安全考量
在处理JSON数据展示时,性能和安全性是两个不可忽视的因素，特别是当数据量达到MB级别时，简单的DOM操作会导致页面卡顿。
大数据量渲染优化
当JSON对象包含成千上万个属性时,一次性渲染所有节点会导致浏览器主线程阻塞，解决方案包括：
- 虚拟滚动：只渲染可视区域内的节点。
- 懒加载：默认折叠深层节点，仅在用户展开时加载子节点数据。
- Web Workers：将JSON解析和格式化任务移至后台线程，避免阻塞UI渲染。
据统计,多数情况下，前端开发者会忽略大数据量的性能影响，直到用户投诉页面卡顿，在涉及大型数据集时，务必提前规划渲染策略。
XSS防护机制
JSON数据可能包含恶意脚本,虽然JSON.stringify()本身不会执行脚本，但如果将数据直接插入innerHTML，攻击者可能注入<script>
- 始终使用
textContent：这是最简单有效的防护手段。 - HTML实体编码：如果必须使用
innerHTML，需对特殊字符（如<,>,&）进行实体编码。 - Content Security Policy (CSP)：配置严格的CSP策略，限制脚本来源，从根本上防止XSS攻击。
常见应用场景与最佳实践
JSON数据展示并非孤立存在,它通常嵌入在特定的业务场景中，理解场景有助于选择最合适的技术方案。
API调试与日志查看
在开发阶段,开发者需要快速查看API返回的数据结构，浏览器插件如Postman或Insomnia是首选，但在生产环境的后台管理系统中，集成一个轻量级的JSON查看器是必要的，建议提供“复制JSON”按钮，方便开发者快速提取数据。
数据配置管理
许多系统允许用户通过JSON格式配置参数,前端框架的主题配置、路由规则等，在这种情况下，除了展示，还需要提供编辑功能。react-json-view等库支持内联编辑，允许用户修改值并实时预览效果。
移动端适配
移动端屏幕空间有限,复杂的JSON结构难以完整展示，最佳实践是默认折叠所有节点，仅显示顶层键名，用户点击键名后，再展开子节点，提供全局搜索功能，帮助用户快速定位特定字段。
HTML显示json数据常见问题解答
如何将JSON数据在HTML中显示为表格？
如果JSON数据是数组形式,且每个对象结构一致，可以将其转换为HTML表格，遍历数组，为每个对象创建一行<tr>，每个属性创建一列<td>，对于嵌套对象，需递归处理或将其序列化为字符串显示，这种方式比纯JSON字符串更具可读性，适合展示列表型数据。
JSON显示乱码怎么办？
乱码通常由编码不一致引起,确保后端返回的HTTP头中包含Content-Type: application/json; charset=utf-8，前端在解析时，若使用fetch，默认已处理UTF-8编码，若使用XMLHttpRequest，需检查responseType设置，HTML页面本身需声明<meta charset="UTF-8">。
如何高亮显示JSON中的关键字？
可以通过正则表达式匹配JSON中的键名、字符串值、数字等，并包裹在带有特定CSS类的<span>标签中，将键名设为蓝色，字符串设为绿色，数字设为红色，这需要手动构建HTML字符串，或使用专门的语法高亮库如highlight.js配合自定义语言定义。
首发原创文章，作者：世雄 - 原生数据库架构专家，如若转载，请注明出处：https://idctop.com/article/351531.html
