Visual Studio 2019导出WIT XML失败，求新版模型解决方案

一、确认项目启用新版工作项自定义模型 #

• 登录VSTS项目，进入项目设置（左下角齿轮图标）
• 依次选择Boards > Processes
• 检查当前使用的流程是否为继承型流程（Inheritance Process）——这是新版自定义模型的核心，旧版为XML自定义的宿主型流程（Hosted XML Process）
• 若当前是宿主型流程，需先迁移到继承型流程：在Processes页面点击迁移按钮，按向导完成操作（迁移前建议备份现有流程配置）

二、新版模型导出WIT定义的两种方法 #

方法1：通过Azure DevOps Portal导出 #

• 进入项目设置的Boards > Processes，选中目标流程
• 点击对应工作项类型（如User Story、Bug）进入详情页
• 点击页面右上角导出按钮，选择导出为JSON格式（新版模型采用JSON替代旧版XML）
• 导出的JSON文件包含该工作项类型的所有配置，涵盖字段、布局、规则等内容

方法2：使用Azure DevOps CLI命令导出 #

• 安装Azure DevOps CLI工具（未安装则先完成安装），打开命令提示符或PowerShell
• 登录Azure DevOps组织：

  az login
  az devops login --organization https://dev.azure.com/你的组织名
  

• 导出指定工作项类型的定义：

  az boards work-item-type show --organization https://dev.azure.com/你的组织名 --project 你的项目名 --name "工作项类型名称" --output json > wit-definition.json
  

• 执行命令后，当前目录会生成包含WIT定义的JSON文件

三、关键注意事项 #

• 继承型流程不支持直接导入旧版XML文件，若需迁移旧版配置，需手动将XML中的字段、规则等转换为JSON格式后，通过Portal或CLI导入
• 仅从本地TFS迁移过来的项目支持宿主型流程（旧版XML模型），纯VSTS项目默认仅支持继承型流程
• 操作前确保拥有项目集合管理员或流程管理员权限，仅项目管理员权限可能不足以完成全部操作

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