.json文件怎么建立?新手也能轻松的3步指南
在编程和数据交互中,.json 文件(JavaScript Object Notation,JavaScript对象表示法)是一种轻量级、易读的数据存储格式,它常用于配置文件、数据交换(如前后端通信)、API响应等场景,如果你是新手,别担心——建立 .json 文件其实非常简单,跟着下面的3步走,就能快速上手。
第一步:理解JSON的基本结构
在创建文件前,先搞清楚 .json 文件的核心规则,JSON 的本质是“键值对”(Key-Value Pair)的集合,类似于编程中的字典或对象,其基本结构包括:
-
数据类型:
- 字符串(String):用双引号 包裹,如
"name"。 - 数字(Number):整数或小数,如
25、14。 - 布尔值(Boolean):
true或false(小写,无引号)。 - 数组(Array):用方括号
[]包裹,多个值用逗号分隔,如["apple", "banana"]。 - 对象(Object):用花括号 包裹,键值对之间用逗号分隔,如
{"age": 18}。 - null:表示空值,小写
null。
- 字符串(String):用双引号 包裹,如
-
语法规则:
- 键必须用双引号 包裹(不能用单引号)。
- 值如果是字符串,也必须用双引号;数字、布尔值、null 不需要引号。
- 键值对之间、数组元素之间用逗号 分隔,但最后一个元素后不能有逗号(否则会报错)。
第二步:选择创建方式并动手操作
创建 .json 文件有两种常用方式:手动创建(适合简单数据)或代码生成(适合动态数据),这里重点介绍最常用的手动创建法,新手最容易上手。
方式1:手动创建(推荐新手)
以 Windows 系统为例,macOS 和 Linux 操作类似,只需调整文件路径和编辑工具。
步骤1:新建文本文件
在桌面或任意文件夹中,右键点击 → 新建 → 文本文档(.txt),得到一个名为“新建文本文档.txt”的文件。
步骤2:修改文件名和后缀
- 将文件名从“新建文本文档.txt”改为
example.json(注意:后缀必须是.json,不是.txt)。 - 如果系统隐藏了文件后缀,需要在文件资源管理器中勾选“查看” → “文件扩展名”,才能手动修改后缀。
步骤3:编辑JSON内容
用记事本(Windows)、文本编辑(macOS)或 VS Code 等代码编辑器打开 example.json,按照 JSON 语法规则写入数据。
示例: 假设我们要存储一个用户信息,内容如下:
{
"name": "张三",
"age": 25,
"isStudent": true,
"hobbies": ["阅读", "跑步", "编程"],
"address": {
"city": "北京",
"district": "海淀区"
},
"phone": null
}
注意事项:
- 花括号 表示一个对象,数组
[]内的元素用逗号分隔。 - 最后一个键值对(如
"phone": null)后不要加逗号,否则会报错。
方式2:代码生成(适合动态数据)
如果数据需要通过程序动态生成(比如从数据库读取后保存为 JSON),可以用 Python、JavaScript 等代码实现。
Python 示例:
import json
# 定义一个字典(Python 中的对象)
data = {
"name": "李四",
"age": 30,
"skills": ["Python", "SQL"]
}
# 将字典写入 JSON 文件
with open("data.json", "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=4) # ensure_ascii=False 支持中文,indent=4 格式化缩进
运行后,会生成一个 data.json 文件,内容格式清晰易读。
第三步:验证JSON文件是否正确
写完 JSON 文件后,一定要验证语法是否正确,否则程序可能无法读取,推荐两种验证方法:
方法1:使用在线工具
访问 JSON 在线验证器(如 JSONLint),将文件内容复制粘贴到框中,点击“Validate”或“验证”,如果提示“Valid JSON”,说明格式正确;如果有错误,会提示具体位置(如“逗号错误”“引号不匹配”)。
方法2:用代码编辑器打开
VS Code、Sublime Text 等编辑器会自动高亮 JSON 语法,如果格式错误(如缺少引号、逗号),会标红提示。
常见问题:新手容易踩的坑
- 引号错误:键或字符串值用了单引号 (如
{ 'name': "张三" }),必须改为双引号 。 - 逗号多余:最后一个键值对或数组元素后加了逗号(如
"age": 25,),删除多余逗号即可。 - 数据类型混淆:布尔值
true/false写成了"true"/"false"(带引号是字符串),或数字加了引号(如"25"是字符串,25才是数字)。
创建 .json 文件的核心就是:理解语法规则 → 手动/代码写入 → 验证格式,手动创建适合简单数据,代码生成适合动态数据,新手建议先从手动创建开始,多练习几次就能熟练,JSON 作为通用的数据格式,学会使用它,能为后续编程、数据处理打下坚实基础!



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