为什么我无法安装自行创建的dotnet项目模板？

1. 校验 .template.config 目录配置 #

• 先检查template.json必填字段是否完整：必须包含identity、name、shortName、tags节点，其中tags下的language、type属性要正确设置，C#项目模板示例配置如下：

{
  "identity": "Your.Custom.Template.Id",
  "name": "自定义C#项目模板",
  "shortName": "customcsharptpl",
  "tags": {
    "language": "C#",
    "type": "project"
  },
  "sourceName": "TemplatePlaceholder",
  "preferNameDirectory": true
}

• 检查.ide.host.json的icon、name字段是否对应正确，项目类型标识要和template.json一致，示例配置：

{
  "icon": "icon.ico",
  "name": "自定义项目模板",
  "order": 1000,
  "projectType": "CSharp"
}

2. 校验打包目录结构 #

• 所有模板文件必须放在VSIX项目的Templates目录下，每个独立模板单独占一个子目录，.template.config文件夹要放在单模板子目录的根层级
• 模板文件的生成操作属性必须设置为Content，且包含在VSIX中属性设置为是

3. 校验VSIX清单配置 #

• 打开source.extension.vsixmanifest文件，在资产标签页添加类型为Microsoft.VisualStudio.ProjectTemplate的资产，路径指向你的模板文件夹根目录
• 检查VSIX的目标版本范围是否包含你当前使用的Visual Studio版本

4. 安装后验证步骤 #

• 安装完成后重启Visual Studio，打开工具 > 命令行 > 开发者命令提示，执行dotnet new list命令查看你的模板是否在列表中
• 如果模板存在但VS新建项目界面不显示，清除VS组件缓存：关闭所有VS窗口，删除%LocalAppData%\Microsoft\VisualStudio\<你的VS版本>\ComponentModelCache目录后重启VS

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