TFS 2017本地版自定义字段无法在新项目表单Web UI显示

你已经排查了客户端缓存、控件布局、权限验证等常见问题，却依然卡在Web UI不显示的环节——这种情况在TFS 2017本地版里确实挺常见的，给你几个针对性的排查和解决方向：

1. 强制刷新TFS服务器端缓存 #

虽然你清了浏览器缓存，但TFS应用层本身可能还保留着旧的表单缓存。试试用witadmin工具执行服务器端缓存刷新：

witadmin refreshcache -collection http://你的TFS服务器地址:8080/tfs/你的集合名称

执行后等待3-5分钟，再重新打开Web UI查看效果。

2. 检查自定义字段的全局权限 #

字段是全局添加的，但新项目对应的用户组可能被遗漏了查看此字段的权限：

• 登录TFS管理控制台，进入目标团队项目集合
• 找到「工作项字段」，定位到你的自定义字段
• 查看权限设置，确保Contributors等核心用户组拥有「查看此字段」的权限（默认应该有，但全局字段批量设置时偶尔会出错）

3. 验证Value Area控件的兼容性 #

Value Area是敏捷模板里的特殊组，专门用于区分业务/技术价值，部分字段类型在Web UI下可能有渲染限制：

• 临时把字段移到Details这类常规组，保存后查看Web UI是否显示
• 如果移到常规组能正常显示，说明是Value Area的渲染逻辑问题，你可以尝试调整字段在组内的排序，或者把字段放在Value Area的单独列中

4. 用witadmin强制导入WIT定义 #

有时候Web编辑器的保存操作可能没有完全同步到服务器，试试基于你已经确认正确的XML重新导入：

witadmin importwitd -collection http://你的TFS服务器地址:8080/tfs/你的集合名称 -p 新项目名称 -f 你的UserStory.xml本地路径

导入完成后，重启TFS的Web应用服务（可选，但能确保服务器加载最新的工作项定义）

5. 安装TFS 2017累积更新 #

你当前使用的15.117版本属于TFS 2017 Update 2，这个版本存在一些表单渲染的已知bug。建议安装TFS 2017的最新累积更新（Update 3.1），很多类似的Web UI显示问题都在后续更新中被修复了。

如果以上方法都无效，你可以去TFS服务器的事件查看器里搜索相关错误日志，这能帮你定位到更底层的渲染故障。

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