为什么我的 Visual Studio 项目模板的描述不显示?

Why won't my Visual Studio project template's description show up?

在 Visual Studio 2017 年,我创建了一个 Console App (.NET Framework) 项目作为基础,并且在使用导出模板向导之前创建项目后没有进行任何更改。我给它起个名字和描述,导出它,然后导入到 Visual Studio。当我去创建一个新项目时,我可以看到我的新模板。它的命名正确,但描述只显示 "MyTemplate" 而不是我给它的实际描述。

我已确保遵循 Description element documentation page 上显示的格式。它没有提及最大长度或禁止使用的字符。 (即使有,我的描述也不包含任何特殊字符;只有字母、空格和句号。)

这是 .vstemplate 文件中包含我的描述的部分(我没有编辑文件的任何部分):

...
<TemplateData>
    <Name>MyNewTemplate</Name>
    <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque vitae mi vitae nibh convallis sagittis pretium id nisi. In rutrum enim quis ipsum gravida egestas. Donec facilisis sodales volutpat. Cras quis vulputate tortor. Vestibulum eget lectus augue. Fusce congue venenatis urna, ut fringilla mi scelerisque et. Nulla facilisi. Vestibulum ullamcorper facilisis quam id pellentesque. </Description>
    <ProjectType>CSharp</ProjectType>
...

我以前创建过其他模板,它们的描述都很好。然而,这个没有。

经过一些实验,我发现描述包含 259 个或更少的字符 时会出现。因此,当我将其缩短为以下内容时,它起作用了:

...
<TemplateData>
    <Name>MyNewTemplate</Name>
    <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque vitae mi vitae nibh convallis sagittis pretium id nisi. In rutrum enim quis ipsum gravida egestas. Donec facilisis sodales volutpat. Cras quis vulputate tortor. Vestibulum eget lector entra</Description>
    <ProjectType>CSharp</ProjectType>
...

文档没有说明最大长度,模板向导也不会阻止您输入超过 259 个字符。因此,如果您发现自己的模板描述没有出现,请检查长度。