JSON5：让配置文件摆脱 JSON 的刻板束缚

admin

2026年11月13日 0:3 本文热度 203

每个项目都免不了配置文件。JSON 凭着简洁走红，却也给开发者埋了不少坑：不能加注释、尾逗号直接报错、对象键必须双引号包裹。这些小限制在大型项目里不断积累，最后就成了开发流程中的磕绊。JSON5 就是为了摆脱这些约束而生的。

JSON5 是什么

JSON5 是 JSON 的超集，既保持兼容又引入了开发者在实战中最需要的特性。规范由 JSON 之父 Douglas Crockford 认可，Chromium、Next.js、Babel、WebStorm 等工具早已在生产环境中广泛采用。

核心诉求就一个：让配置文件更好维护。对比 JSON 的刻板，JSON5 允许像写代码一样组织配置——加注释、用单引号、省掉不必要的引号。这减少了书写摩擦。

JSON5 的主要特性

注释支持 是最实用的改进。配置中直接加注释，再也不用在代码里写注释映射表。

   {
  // 数据库连接配置
  db: {
    host: 'localhost',  // 开发环境直连本地
    port: 5432,
    /* 
     * 连接池大小
     * 生产环境建议设置为 100+
     */
    maxConnections: 20,
  }
}

在纯 JSON 里这是非法的，JSON5 完全接受。

对象键可以省引号。只要符合标识符规则就不需要双引号，配置文件看起来清爽多了。

   {
  serverPort: 8080,      // 不需要 "serverPort"
  enableCache: true,
  apiTimeout: 5000,
}

尾逗号合法化。数组或对象最后一个元素后面的逗号，在 JSON 中是错，在 JSON5 中正常处理。这对频繁编辑配置的场景特别有用。

   {
  servers: [
    'api-1.example.com',
    'api-2.example.com',
    'api-3.example.com',  // 这个逗号在 JSON 中是非法的
  ],
}

字符串灵活写法。单引号、双引号都可以。JSON5 还支持特殊数值如 NaN 和 Infinity。

   {
  apiTimeout: 5000,
  maxRetries: 3,
  invalidValue: NaN,
  largeNumber: Infinity,
}

生产应用与工具生态

JSON5 已经不是小众规范。Chromium、Next.js、Babel、WebStorm 这些工具的广泛采用足以说明市场已经接受它作为现代配置标准。

Node.js 的 json5 包提供标准支持，用法简单：

   const JSON5 = require('json5');
const config = JSON5.parse(jsonString);

Go 生态虽然起步较晚，但也有可靠的库。github.com/yosuke-furukawa/json5 和 github.com/titanous/json5 等都能完整解析 JSON5。

性能与开发体验的权衡

JSON5 解析器要处理注释符号、多种引号、特殊数值等，性能确实比 JSON 低一点。但对配置文件这类非关键路径来说，这点差异无关紧要。真正的价值在开发体验。

   // JSON - 严格但冗长
{
  "enable_feature": true,
  "timeout": 5000,
  "servers": [
    "server1",
    "server2"
  ]
}

// JSON5 - 灵活且可读
{
  // 启用功能开关
  enableFeature: true,
  timeout: 5000,
  servers: [
    'server1',
    'server2',  // 可以有尾逗号
  ],
}