You need to enable JavaScript to run this app.
最新活动
大模型
产品
解决方案
定价
生态与合作
支持与服务
开发者
了解我们

Visual Studio自定义项模板未显示在「添加新项」菜单问题求助

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 开发人员命令提示符」(以管理员身份运行),执行:
    devenv /installvstemplates
    
    执行完成后重启VS。
  • 方法2: 删除缓存目录(替换2026_*为你的VS版本对应的缓存文件夹):
    %USERPROFILE%\AppData\Local\Microsoft\VisualStudio\2026_*\ItemTemplateCache
    
    然后重启VS。

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格式错误等)。

有其他细节可以补充,我再帮你排查!

火山引擎 最新活动