Visual Studio自定义项模板未显示在「添加新项」菜单问题求助
看起来你遇到了VS项模板加载的典型问题——虽然导出提示失败但生成了ZIP文件,却无法在「添加新项」菜单中找到。结合你贴出的所有文件内容,我整理了高优先级排查点+针对性修复步骤,应该能快速解决问题:
1. 最可能的元凶:图标/预览图文件名拼写不匹配
看你提供的MyTemplate.vstemplate配置:
<Icon>__TemplateIcon.ico</Icon> <PreviewImage>__PreviewImage.png</PreviewImage>
但你实际的文件是_TemplateIcon.ico和_PreviewImage.png(少了一个下划线!)。VS加载模板时,如果找不到指定的图标/预览图文件,会直接跳过该模板,不会在菜单中显示。
修复: 修改MyTemplate.vstemplate中的路径,与实际文件名完全一致:
<Icon>_TemplateIcon.ico</Icon> <PreviewImage>_PreviewImage.png</PreviewImage>
2. 确认ZIP文件结构(常见致命错误)
VS对项模板的ZIP结构有严格要求:解压ZIP后,所有文件必须直接在根目录,不能嵌套在子文件夹中。
✅ 正确结构:
Assets Db Entity.zip ├─ AssetsDbEntity.cs ├─ MyTemplate.vstemplate ├─ _TemplateIcon.ico └─ _PreviewImage.png
❌ 错误结构(导出时极易出现):
Assets Db Entity.zip └─ Assets Db Entity ← 多余的嵌套子文件夹 ├─ AssetsDbEntity.cs └─ ...
修复: 重新选中所有文件(不要选文件夹),直接压缩为ZIP,确保内容平级。
3. 模板放置路径必须精准
VS 2026的C#项模板默认存储路径为:
%USERPROFILE%\Documents\Visual Studio 2026\Templates\ItemTemplates\Visual C#
如果是VS 2026预览版,路径为:
%USERPROFILE%\Documents\Visual Studio 2026 Preview\Templates\ItemTemplates\Visual C#
注意: 要把ZIP文件直接放在这个目录下,不能放在子文件夹中;如果目录不存在,手动创建即可。
4. 强制刷新VS模板缓存
VS会缓存旧的模板数据,即使你修复了问题,旧缓存可能仍会导致模板不显示。可以通过以下方式刷新:
- 方法1(推荐): 打开「VS 2026 开发人员命令提示符」(以管理员身份运行),执行:
执行完成后重启VS。devenv /installvstemplates - 方法2: 删除缓存目录(替换
2026_*为你的VS版本对应的缓存文件夹):
然后重启VS。%USERPROFILE%\AppData\Local\Microsoft\VisualStudio\2026_*\ItemTemplateCache
5. 补充:导出失败的根源(不影响显示,但影响模板可用性)
你提到导出时提示失败,原因是AssetsDbEntity.cs引用了SLT.Assets程序集,但vstemplate的<References />节点为空。VS导出时会检测项目引用,若模板中未包含依赖引用会提示失败,但不影响模板文件生成。这个问题不会导致模板不显示,但用户使用时会出现编译错误,后续可在<TemplateContent>中补充引用:
<References> <Reference> <Assembly>SLT.Assets, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null</Assembly> </Reference> </References>
最终验证
完成所有修复后,重启VS,打开任意C#项目,右键→添加→新建项,在搜索框输入「Assets Db Entity」,应该就能看到你的模板了。如果还是找不到,可以打开VS的输出窗口(视图→输出),在「显示输出来源」下拉菜单选择「模板」,查看模板加载的错误日志,里面会明确标注问题原因(比如文件找不到、XML格式错误等)。
有其他细节可以补充,我再帮你排查!




