JSON文件怎么制作:从零开始的详细指南
JSON(JavaScript Object Notation,JavaScript对象表示法)是一种轻量级的数据交换格式,因其易读、易解析、结构灵活的特点,被广泛应用于Web开发、API接口配置、数据存储等场景,如果你需要手动制作JSON文件,本文将从基础概念到具体操作,一步步教你完成。
先搞懂:JSON文件到底是什么?
在制作JSON文件前,首先要明确它的核心特点:
- 文本格式:JSON文件本质是纯文本文件,后缀名为
.json(如data.json、config.json)。 - 结构化数据:通过“键值对”(Key-Value)存储数据,类似Python中的字典、JavaScript中的对象。
- 层级关系:支持嵌套结构,可通过数组和对象组合复杂数据。
JSON的基本语法规则(制作前必看!)
JSON的语法非常严格,写错一个符号都可能导致文件无法解析,记住以下核心规则:
数据类型:JSON只支持6种基本数据
- 字符串:用双引号包裹(单引号无效!),如
"name"、"北京"。 - 数字:整数或浮点数,无需引号,如
25、14。 - 布尔值:
true或false(全小写,首字母不能大写)。 - null:表示空值,固定为
null(全小写)。 - 数组:用方括号
[]包裹,元素间用逗号分隔,如["苹果", "香蕉", 123]。 - 对象:用花括号包裹,内部是“键值对”,键值间用冒号分隔,多个键值对用逗号分隔,如
{"name": "张三", "age": 20}。
核心符号:别用错标点!
- 大括号:表示对象(整体数据结构)。
- 方括号
[]:表示数组(有序列表)。 - 冒号:分隔键和值(
"键": 值)。 - 逗号:分隔元素(数组内、对象键值对间),但最后一个元素后不能加逗号(常见错误!)。
特殊规则:这些细节不能错
- 所有字符串必须用双引号(),单引号()会报错。
- 键必须是字符串(双引号包裹),值可以是上述6种数据类型。
- 不能有注释(原生JSON不支持,但某些工具可扩展)。
制作JSON文件的两种常用方法
方法1:手动编写(适合小数据量)
最直接的方式:用文本编辑器(如Windows记事本、macOS文本编辑、VS Code)直接编写内容,保存时修改后缀名为.json。
步骤1:打开文本编辑器
推荐使用VS Code(支持语法高亮,能实时提示错误),或系统自带的记事本/文本编辑。
步骤2:按JSON语法编写内容
以存储“学生信息”为例,编写以下内容:
{
"class": "三年二班",
"students": [
{
"id": 1001,
"name": "李华",
"age": 16,
"scores": {
"math": 95,
"english": 88
},
"isPresent": true
},
{
"id": 1002,
"name": "王芳",
"age": 15,
"scores": {
"math": 92,
"english": 90
},
"isPresent": false
}
],
"teacher": "张老师",
"extraInfo": null
}
步骤3:保存为.json文件
- 点击“文件”→“另存为”,选择保存路径。
- 文件名修改为
student_info.json(后缀名必须是.json)。 - 编码选择UTF-8(避免中文乱码),保存即可。
常见错误及修正
如果编写时出现以下问题,文件可能无法被程序读取:
- 错误1:键用单引号,如
'name': "张三"→ 修正为"name": "张三"。 - 错误2:最后一个元素后加逗号,如
"students": [1, 2, 3,]→ 修正为"students": [1, 2, 3]。 - 错误3:字符串用双引号但内容含双引号未转义,如
"desc": "他说:"你好""→ 修正为"desc": "他说:\"你好\""(用\转义)。
方法2:从其他格式转换(适合大数据量)
如果已有数据(如Excel、Python字典、数据库表),可通过工具快速转换为JSON文件,避免手动编写。
场景1:Excel表格转JSON
工具推荐:在线转换网站(如ConvertCSV、Excel to JSON)、Excel插件(如“Power Query”)。
操作步骤(以在线网站为例):
- 打开Excel表格,整理好数据(第一行建议作为键,后续为值)。
- 保存为CSV格式(“文件”→“另存为”→选择“CSV UTF-8(逗号分隔)”)。
- 访问在线转换网站(如https://convertcsv.com/csv-to-json.htm),上传CSV文件。
- 点击“Convert to JSON”,下载生成的JSON文件。
场景2:Python字典转JSON
如果你用Python处理数据,可通过json模块将字典保存为JSON文件。
示例代码:
import json
# 定义一个字典(Python对象)
data = {
"name": "产品信息",
"items": [
{"id": 1, "price": 99.9, "in_stock": True},
{"id": 2, "price": 149.9, "in_stock": False}
]
}
# 将字典保存为JSON文件(ensure_ascii=False支持中文,indent=4格式化缩进)
with open("product.json", "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=4)
print("JSON文件已生成:product.json")
运行后,会生成product.json格式化后易读:
{
"name": "产品信息",
"items": [
{
"id": 1,
"price": 99.9,
"in_stock": true
},
{
"id": 2,
"price": 149.9,
"in_stock": false
}
]
}
如何验证JSON文件是否正确?
制作完成后,务必验证文件格式是否正确,避免因语法错误导致程序报错。
方法1:用文本编辑器语法高亮
用VS Code打开JSON文件,如果语法正确,代码会自动高亮显示(键值用不同颜色,括号匹配);如果报错,左下角会显示红色提示(如“Unexpected token }”)。
方法2:在线JSON验证工具
访问在线JSON验证网站(如https://jsonlint.com/),将JSON文件内容粘贴到输入框,点击“Validate”,若提示“Valid JSON”,则格式正确;否则会显示错误位置和原因。
方法3:用命令行工具(适合开发者)
- Windows:安装Node.js后,打开命令行,输入
jsonlint 文件名.json(需先全局安装jsonlint:npm install -g jsonlint)。 - macOS/Linux:直接用
python3 -m json.tool 文件名.json,若无报错则格式正确。
JSON文件的常见应用场景
了解制作方法后,你可能需要在不同场景中使用JSON文件:
- API接口数据:后端向前端返回数据(如用户信息、商品列表)常用JSON格式。
- 配置文件:存储程序配置参数(如数据库连接信息、功能开关)。
- 数据存储:小型应用用JSON存储简单数据(如博客文章、笔记)。
- 数据交换:不同系统间传输数据(如从数据库导出JSON,供其他系统读取)。
制作JSON文件的3个关键步骤
- 明确数据结构:先规划好数据层级(哪些是对象,哪些是数组,键名如何定义)。
- 按语法编写/转换:手动编写时严格遵循JSON规则,或用工具从



还没有评论,来说两句吧...