如何自定义TFS 2018工作项状态列表及颜色(VS2022环境)
我完全懂你现在的困扰——VS2022找不到适配TFS2018的旧版扩展,没法像以前那样用图形化工具轻松改状态颜色和自定义状态。别慌,咱们用TFS自带的命令行工具和Web UI就能搞定这俩需求,一步步来:
一、设置工作项状态颜色
TFS2018的状态颜色配置存在过程配置文件里,咱们可以通过witadmin命令行工具导出、修改再导入这个文件,具体操作:
定位witadmin工具:它一般藏在VS的安装路径里,比如VS2022的路径可能是
C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer,找到witadmin.exe即可。导出过程配置文件:以管理员身份打开命令提示符,切换到上述路径,运行以下命令(替换成你的TFS信息):
witadmin exportprocessconfig /collection:http://你的TFS服务器地址:8080/tfs/项目集合名称 /p:项目名称 /f:C:\temp\ProcessConfig.xml修改状态颜色:打开导出的
ProcessConfig.xml,找到WorkItemColors节点,每个WorkItemColor对应一个状态,格式如下:<WorkItemColor primary="十六进制颜色代码" secondary="浅色代码" name="状态名称" />比如要把“已完成”设为深绿色,就添加或修改一行:
<WorkItemColor primary="#007836" secondary="#C6E4D6" name="已完成" />颜色代码和网页通用的十六进制格式一致,随便搜个颜色picker就能拿到合适的代码。
导入修改后的配置:运行命令把修改好的文件导回TFS:
witadmin importprocessconfig /collection:http://你的TFS服务器地址:8080/tfs/项目集合名称 /p:项目名称 /f:C:\temp\ProcessConfig.xml执行完刷新TFS Web UI,就能看到状态颜色已经更新了。
二、自定义工作项状态列表
自定义状态需要修改对应工作项类型(比如Bug、任务)的定义,有两种方法可选:
方法1:用witadmin命令行
导出工作项类型定义:运行命令导出目标工作项类型的XML文件:
witadmin exportwitd /collection:http://你的TFS服务器地址:8080/tfs/项目集合名称 /p:项目名称 /n:工作项类型名称(比如Bug) /f:C:\temp\Bug.xml修改状态列表:打开导出的XML文件,找到
States节点,你可以添加新状态、修改现有状态的名称或属性,比如新增一个“待评审”状态:<State value="待评审" type="InProgress" />这里的
type可选值有Proposed(提议)、InProgress(进行中)、Resolved(已解决)、Completed(已完成),这个类型会影响工作项在流程中的状态分类。导入修改后的定义:运行命令把修改后的文件导回TFS:
witadmin importwitd /collection:http://你的TFS服务器地址:8080/tfs/项目集合名称 /p:项目名称 /f:C:\temp\Bug.xml
方法2:用TFS Web UI(更直观)
- 打开TFS Web Portal,进入你的项目,点击右上角的齿轮图标(项目设置)。
- 左侧菜单选择工作项类型,找到你要修改的类型(比如任务)并点击。
- 切换到状态标签页,这里可以直接添加、编辑或删除状态,还能设置状态的类别(进行中、已完成等),修改完点击保存就生效了。
注意事项
- 修改前最好先备份原始的配置文件,万一改崩了还能回滚。
- 如果修改的是共享过程模板,所有使用该模板的项目都会受影响;如果是单个项目的自定义,只会作用于当前项目。
内容的提问来源于stack exchange,提问作者boggy

