如何手动创建一个JSON文件：从基础到实践的完整指南
什么是JSON文件？
JSON（JavaScript Object Notation，JavaScript对象表示法）是一种轻量级的数据交换格式，以易于阅读和编写的文本形式存储结构化数据，它常用于配置文件、数据传输（如API接口）、数据库存储等场景，一个JSON文件的后缀名通常是 .json遵循严格的语法规则，确保程序能正确解析。
手动创建JSON文件的准备工作
在手动创建JSON文件前,需了解以下核心语法规则，避免因格式错误导致文件无法使用：
-
数据结构：JSON支持两种核心结构：
- 对象（Object）：用 包裹，表示无序的键值对集合，格式为
{"key1": value1, "key2": value2}。 - 数组（Array）：用
[]包裹，表示有序的值列表，格式为[value1, value2, value3]。
- 对象（Object）：用 包裹，表示无序的键值对集合，格式为
-
数据类型：JSON支持以下数据类型：
- 基本类型：字符串（需用双引号 包裹，如
"name"）、数字（如25、14）、布尔值（true/false）、null（表示空值）。 - 复合类型：对象（如
{"age": 30}）、数组（如["apple", "banana"]）。
- 基本类型：字符串（需用双引号 包裹，如
-
语法规范：
- 键必须用双引号（不能用单引号），值如果是字符串也必须用双引号；
- 键值对之间用英文逗号 分隔（最后一个键值对后不能加逗号）；
- 数组或对象嵌套时,需保证层级结构闭合（如
{ "user": { "name": "Tom" } }）。
手动创建JSON文件的详细步骤
步骤1：确定JSON数据结构
先明确你要存储的数据内容,设计好键值对的组织形式，要创建一个存储用户信息的JSON文件，结构可设计为：
{
"username": "zhangsan",
"age": 25,
"isStudent": false,
"courses": ["math", "english"],
"address": {
"city": "Beijing",
"district": "Haidian"
}
}
步骤2：选择编辑工具
手动创建JSON文件无需专业软件,任何文本编辑器均可，推荐以下工具：
- 基础工具：Windows记事本、macOS文本编辑、Linux的gedit/vim；
- 进阶工具：VS Code（支持语法高亮，便于检查错误）、Sublime Text、Notepad++（能实时提示JSON格式是否正确）。
步骤3：编写JSON内容
打开编辑器,按照设计的结构输入数据，注意遵守语法规则：
- 输入对象起始符号 和结束符号 ；
- 逐个添加键值对,键用双引号，值根据类型填写（字符串加双引号、布尔值用
true/false等）； - 多个键值对之间用 分隔，最后一个键值对后不加逗号；
- 如果需要嵌套（如对象中的对象、数组），用 或
[]分层嵌套，确保层级闭合。
以用户信息为例,完整内容如下：
{
"username": "zhangsan",
"age": 25,
"isStudent": false,
"courses": ["math", "english"],
"address": {
"city": "Beijing",
"district": "Haidian"
}
}
步骤4：保存文件为JSON格式
- 点击编辑器的“保存”或“另存为”选项；
- 在“文件名”中输入名称，必须以
.json（如user_info.json），注意后缀名显示（若编辑器默认隐藏后缀，需手动添加）； - 选择编码格式为 UTF-8（避免中文或特殊字符乱码），然后保存。
步骤5：验证JSON文件格式是否正确
保存后需检查文件是否符合JSON规范,避免因语法错误导致程序无法解析，常用验证方法：
- 编辑器提示：用VS Code等工具打开，若格式错误，编辑器会标红提示（如缺少逗号、双引号未闭合）；
- 在线验证工具：访问 JSON在线验证器，将文件内容粘贴到输入框，若显示“Valid JSON”，则格式正确；
- 命令行验证：Linux/macOS下可通过
python3 -m json.tool 文件名.json命令，若无报错则格式正确（Windows需安装Python）。
常见错误及避坑指南
手动创建JSON文件时,以下错误最常见，需特别注意：
| 错误类型 | 错误示例 | 正确示例 | 说明 |
|---|---|---|---|
| 键或字符串值用单引号 | {'name': 'Tom'} |
{"name": "Tom"} |
JSON要求键和字符串值必须用双引号 |
| 末尾键值对后加逗号 | {"name": "Tom", "age": 20,} |
{"name": "Tom", "age": 20} |
最后一个键值对或数组元素后不能加逗号 |
| 缺少引号或括号 | {name: "Tom"} 或 {"name": "Tom |
{"name": "Tom"} |
键必须加双引号，对象/数组需用 /[] 闭合 |
| 数组元素类型混用 | [1, "two", true,] |
[1, "two", true] |
数组元素可以是任意类型，但末尾不能加逗号 |
| 嵌套层级未闭合 | {"user": {"name": "Tom"} |
{"user": {"name": "Tom"}} |
嵌套的对象或数组需保证起始和结束符号匹配 |
实践案例：创建一个简单的配置文件
假设我们要创建一个名为 config.json 的应用配置文件，包含应用名称、版本、调试开关和服务器地址，步骤如下：
-
设计结构：
{ "appName": "MyApp", "version": "1.0.0", "debugMode": true, "server": { "host": "localhost", "port": 8080 } } -
编写并保存：
- 用VS Code打开，输入上述内容；
- 保存为
config.json，编码选择UTF-8。
-
验证：
- 用JSON在线验证器粘贴内容,显示“Valid JSON”即成功；
- 用Python验证：新建
test.py，写入import json; f = open('config.json'); data = json.load(f); print(data)，运行后输出字典内容，说明文件可正常解析。
手动创建JSON文件的核心在于“明确结构、遵守语法、验证格式”，只需先设计数据组织形式，再用文本编辑器按规范编写内容，最后保存为 .json 后缀并验证，即可完成文件创建，这一基础技能，不仅能帮助你快速处理配置文件、存储简单数据，也为后续学习API接口调用、数据交换等场景打下基础。
还没有评论，来说两句吧...