返回博客

如何在记事本中创建 .JSON 文件

Jul 3, 20263 min read

JSON 是带有严格规则的纯文本,记事本完全可以用来编写。人们容易出错的地方在于语法,而不是工具。只要结构正确,保存文件反而是最简单的部分。

什么是 JSON 文件?

JSON 代表 JavaScript 对象符号(JavaScript Object Notation)。它以大括号内的键值对形式存储数据,并支持嵌套对象和数组。应用程序、API 和配置文件使用它是因为它轻量且每种主流语言都能读取它。

一个基本的 JSON 文件如下所示:

{
  "name": "John",
  "age": 28,
  "isActive": true,
  "skills": ["writing", "editing"]
}

逐步指南:在记事本中创建 JSON 文件

第一步:打开记事本

在你的电脑上打开记事本,或者在任何浏览器中使用免费的 在线记事本

第二步:以左大括号开始

每个 JSON 文件都以 `{`(对象)或 `[`(数组)开头。大多数文件都是以对象开始的。

第三步:添加你的键和值

用双引号包裹每个键,后面跟一个冒号,然后是对应的值。每对键值之间用逗号隔开。

{
  "title": "Sample File",
  "version": 1
}

第四步:正确关闭文件

确保每个左括号或大括号都有一个对应的右括号。对象或数组中的最后一对键值后面不能加尾随逗号。

第五步:保存为 .json 扩展名

转到“文件”,然后点击“另存为”。在“保存类型”下拉菜单中选择“所有文件”。为文件命名并加上 .json 扩展名,例如 data.json。如果不更改此下拉菜单直接保存,会生成一个无法被识别为 JSON 的 .txt 文件。

第六步:在使用前进行验证

将文件粘贴到 JSON 编辑器中,以确认其在脚本或应用程序中使用前是有效的。在这里快速检查可以免去以后调试的麻烦。

需要记住的 JSON 语法规则

  • 只能使用双引号。键和字符串值需要使用双引号,而不是单引号。

  • 没有尾随逗号。对象或数组中的最后一项后面不能有逗号。

  • 不支持注释。标准的 JSON 文件内部不支持 `//` 或 `/* */` 形式的注释。

  • 布尔值必须全小写。使用 `true` 和 `false`,而不是 `True` 或 `FALSE`。

  • 数字不需要引号。写作 `28`,而不是 `"28"`,除非该值本身应该作为文本处理。

常见错误及如何避免

问题:键值对之间缺少逗号。修复:除最后一对外,每一对后面都需要加逗号。

问题:括号或大括号不匹配。修复:数一下你的 `{}` 和 `[]` 对。验证器会指出不匹配的具体行数。

问题:字符串内部未转义的引号。修复:使用反斜杠转义内部引号,例如 `"He said \"hello\""`。

问题:键没有加引号。修复:每个键都必须用双引号包裹,即使是像 `id` 或 `name` 这样简单的键也是如此。

结论

一个 JSON 文件本质上只是遵循严格格式的文本。使用双引号编写键和值,匹配好括号,省去尾随逗号,并以 .json 扩展名保存。在使用前通过验证器运行一次,你就大功告成了。

相关文章