如何在JSON Schema中标记属性为已弃用？该规范是否支持此操作？

咱先明确说结论：JSON Schema完全支持标记属性为已弃用，具体实现要看你使用的JSON Schema版本，主流有两种方案，下面给你一步步讲清楚：

1. 使用官方标准的deprecated关键字（推荐，Draft 7及以上版本） #

从JSON Schema Draft 7开始，官方正式引入了deprecated布尔关键字，只要把它设为true，就能直接标记属性为已弃用。同时建议搭配description字段说明替代方案，让使用者一眼就清楚该换用什么属性。

示例代码：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "old_user_name": {
      "type": "string",
      "deprecated": true,
      "description": "已弃用，请使用`user_display_name`属性替代"
    },
    "user_display_name": {
      "type": "string",
      "description": "用户显示名称（替代旧的old_user_name）"
    }
  }
}

目前主流的JSON Schema验证工具（比如AJV、Zod的Schema适配）都会识别这个关键字，在验证时自动给出警告提示——不会直接阻止使用，但会明确告知属性已过时。

2. 兼容旧版本的方案（Draft 6及更早） #

如果你的场景还在使用Draft 6或更早的版本，当时官方还没推出deprecated标准化关键字，这时候可以通过description字段明确标注弃用信息。虽然没有机器可直接识别的标准关键字，但依然能给开发者清晰的提示，适合兼容性要求高的场景：

示例代码：

{
  "$schema": "http://json-schema.org/draft-06/schema#",
  "type": "object",
  "properties": {
    "old_user_name": {
      "type": "string",
      "description": "⚠️ 已弃用！请使用`user_display_name`属性替代"
    },
    "user_display_name": {
      "type": "string"
    }
  }
}

额外进阶：限制旧属性的使用（可选） #

如果你希望在使用旧属性时抛出更明确的提示，甚至直接阻止使用，可以结合if/then关键字实现逻辑校验：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "old_user_name": {
      "type": "string",
      "deprecated": true
    },
    "user_display_name": {
      "type": "string"
    }
  },
  "if": {
    "required": ["old_user_name"]
  },
  "then": {
    "warning": "使用了已弃用的old_user_name属性，请切换为user_display_name"
    // 部分工具支持自定义警告，或者用"errorMessage"直接报错（根据需求选择）
  }
}

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