如何将两个JSON Schema合并为单文件：嵌入一个作为另一个字段

当然可以实现！你不需要只靠生硬的代码“粘贴”，JSON Schema本身就有规范的方式来把Schema B直接内嵌到Schema A的指定属性中，下面给你两种实用方案：

方案1：直接内嵌Schema B的完整内容 #

这是最直接的方式——把Schema B的所有字段原封不动地放到Schema A目标属性的定义里。这种方式会生成一个完全扁平化的单文件Schema，没有任何引用。

举个例子：
假设Schema B是用户信息的Schema：

{
  "type": "object",
  "properties": {
    "userId": { "type": "string" },
    "name": { "type": "string" },
    "email": { "type": "string", "format": "email" }
  },
  "required": ["userId", "name"]
}

现在要把它作为Schema A（订单Schema）的user属性，直接内嵌后的完整Schema如下：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "orderId": { "type": "string" },
    "totalAmount": { "type": "number", "minimum": 0 },
    // 直接嵌入Schema B的内容作为user属性的定义
    "user": {
      "type": "object",
      "properties": {
        "userId": { "type": "string" },
        "name": { "type": "string" },
        "email": { "type": "string", "format": "email" }
      },
      "required": ["userId", "name"]
    }
  },
  "required": ["orderId", "totalAmount", "user"]
}

注意：如果Schema B里有$id这类全局关键字，需要移除或调整，避免和Schema A的全局配置冲突。

方案2：使用$defs（或definitions）复用并内嵌 #

如果想兼顾可维护性（比如后续要修改Schema B的内容，只改一处），同时保持单文件，可以把Schema B定义在Schema A的$defs（JSON Schema 2019-09及以后版本）或definitions（旧版本）区块里，然后用$ref引用它。这种方式本质还是单文件，只是用内部引用替代了重复粘贴，比单纯的代码粘贴更规范、更易维护。

示例如下：

{
  "$schema": "http://json-schema.org/draft-2020-12/schema#",
  "type": "object",
  "properties": {
    "orderId": { "type": "string" },
    "totalAmount": { "type": "number", "minimum": 0 },
    // 通过内部引用指向$defs里的userSchema
    "user": { "$ref": "#/$defs/userSchema" }
  },
  "required": ["orderId", "totalAmount", "user"],
  // 在这里定义Schema B的内容
  "$defs": {
    "userSchema": {
      "type": "object",
      "properties": {
        "userId": { "type": "string" },
        "name": { "type": "string" },
        "email": { "type": "string", "format": "email" }
      },
      "required": ["userId", "name"]
    }
  }
}

这种方式的好处是：如果后续要修改用户信息的Schema，只需要修改$defs里的userSchema部分，所有引用它的地方都会自动生效，避免了手动粘贴可能带来的不一致问题。

总结一下：

• 如果就想要完全无引用的单文件，方案1直接内嵌最直接；
• 如果想兼顾复用性和单文件，方案2更符合JSON Schema的规范，比单纯编程粘贴更可靠。

内容的提问来源于stack exchange，提问作者kace91