如何创建.json文件:从零开始的实用指南
.json(JavaScript Object Notation)文件是一种轻量级的数据交换格式,因其易读、易解析的特性,被广泛应用于Web开发、API接口配置、数据存储等场景,如果你是刚接触.json的新手,别担心——创建.json文件其实非常简单,本文将从零开始,手把手教你创建.json文件,涵盖基础语法、创建方法、常见错误避坑及实用技巧。
先搞懂:什么是.json文件?
.json文件本质上是一个纯文本文件遵循特定的数据格式规范,它以“键值对”(Key-Value Pair)的形式组织数据,类似Python中的字典或JavaScript中的对象,结构清晰,机器和人类都能轻松阅读。
核心语法规则(牢记这5点):
-
数据结构:支持两种结构——
- 对象(Object):用 包裹,由多个键值对组成,如
{"name": "张三", "age": 18}。 - 数组(Array):用
[]包裹,由多个值(可以是对象、基本类型等)组成,如[{"name": "张三"}, {"name": "李四"}]。
- 对象(Object):用 包裹,由多个键值对组成,如
-
键值对规则:
- 键(Key)必须是字符串,且必须用双引号 包裹(单引号会报错!)。
- 值(Value)可以是:字符串、数字、布尔值(
true/false)、数组、对象、null(注意:null是小写,不是NULL或Null)。
-
分隔符:
- 键与值之间用冒号 分隔,如
"name": "张三"。 - 键值对之间用逗号 分隔,最后一个键值对后面不能加逗号(否则会报错!)。
- 键与值之间用冒号 分隔,如
-
嵌套支持:对象和数组可以多层嵌套,如
{"user": {"name": "张三", "hobbies": ["读书", "跑步"]}}。 -
文件扩展名:必须使用
.json,如data.json、config.json。
创建.json文件的3种实用方法
方法1:手动创建(最简单,适合小文件)
适合临时创建少量数据的.json文件,无需任何工具,用系统自带的文本编辑器即可。
操作步骤(以Windows为例):
- 新建文本文档:在桌面或目标文件夹右键 → 新建 → 文本文档,命名为
data.txt(后续会改扩展名)。 - :双击打开文件,输入符合.json语法的内容,
{ "name": "张三", "age": 18, "isStudent": true, "hobbies": ["读书", "跑步", "游戏"], "address": null } - 保存为.json文件:
- 点击“文件”→“另存为”,选择保存路径;
- 在“保存类型”中选“所有文件()”;
- 将文件名从
data.txt改为data.json(注意:后缀名要显示可见,若看不到后缀名,需在文件资源管理器中勾“查看”→“文件扩展名”)。
方法2:使用代码生成(适合动态/批量数据)
当数据需要动态生成(如从数据库提取、根据用户输入生成)时,用代码创建更高效,不同语言的实现方式略有不同,以下是Python和JavaScript的示例。
示例1:用Python生成.json文件
Python内置了json模块,可直接将字典转换为.json字符串并写入文件。
import json
# 准备数据(字典格式)
data = {
"name": "李四",
"age": 20,
"isStudent": False,
"courses": ["数学", "英语"],
"info": None
}
# 写入.json文件(使用utf-8编码避免中文乱码)
with open("student.json", "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2) # ensure_ascii=False支持中文,indent=2格式化缩进
print("student.json文件已创建!")
运行后,会生成student.json格式化如下(indent=2作用是缩进,提升可读性):
{
"name": "李四",
"age": 20,
"isStudent": false,
"courses": [
"数学",
"英语"
],
"info": null
}
示例2:用JavaScript生成.json文件
在Node.js环境中,可通过fs(文件系统)模块写入.json文件。
const fs = require('fs');
// 准备数据(对象格式)
const data = {
"name": "王五",
"age": 22,
"skills": ["JavaScript", "Python"],
"contact": {
"email": "wangwu@example.com",
"phone": null
}
};
// 转换为JSON字符串(使用JSON.stringify格式化)
const jsonString = JSON.stringify(data, null, 2); // 第三个参数2表示缩进2个空格
// 写入文件(同步方式)
fs.writeFileSync('user.json', jsonString, 'utf-8');
console.log('user.json文件已创建!');
运行后生成user.json与Python示例类似,支持嵌套对象和数组。
方法3:使用在线工具或编辑器(适合新手/复杂文件)
如果你对语法不熟悉,或需要编辑大型.json文件,推荐使用专用工具:
工具1:在线JSON生成器
- 推荐工具:JSON Generator、Mockaroo
- 优点:可视化操作,无需记语法,支持生成测试数据;
- 用法:选择字段类型(字符串、数字等)、设置规则(如姓名、邮箱格式),点击“生成”即可下载.json文件。
工具2:代码编辑器(VS Code、Sublime Text等)
- 推荐编辑器:Visual Studio Code(VS Code)对.json支持极佳,自带语法高亮、格式化、错误提示;
- 用法:新建文件 → 保存为
.json→ 输入内容时,编辑器会实时提示语法错误(如引号缺失、逗号多写); - 快捷操作:
- 格式化代码:
Shift+Alt+F(Windows/Linux)或Shift+Option+F(Mac); - 验证语法:
Ctrl+Shift+P→ 输入“JSON: Validate”检查文件是否合法。
- 格式化代码:
常见错误避坑(新手必看)
创建.json文件时,以下错误最常见,一旦出现会导致文件无法被程序解析:
错误1:键没有用双引号包裹
// 错误示例(键用单引号)
{'name': '张三', 'age': 18}
// 正确写法
{"name": "张三", "age": 18}
错误2:最后一个键值对后面加逗号
// 错误示例(最后一个键值对后有多余逗号)
{
"name": "张三",
"age": 18,
}
// 正确写法
{
"name": "张三",
"age": 18
}
错误3:值的数据类型错误
// 错误示例(布尔值用大写,数字加引号)
{
"isStudent": True, // 正确是 true
"age": "18" // 数字不应加引号(除非是字符串类型的数字)
}
// 正确写法
{
"isStudent": true,
"age": 18
}
错误4:文件扩展名错误
将文件保存为.txt、.doc等,会导致程序无法识别,务必确保扩展名是.json(若系统隐藏扩展名,需手动开启显示)。
错误5:编码问题(中文乱码)
手动创建时,若用Windows自带的“记事本”保存,默认可能用GBK编码,导致中文显示为乱码,建议:
- 用VS Code、Notepad++等支持UTF-8的编辑器;
- 若用记事本,保存时选“UTF-8”编码(“另存为”→“编码”下拉框选“UTF-8”)。
实用技巧:让.json文件更规范
格式化缩进,提升可读性
.json文件支持缩进(



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