SSDT 2017自定义SSRS报表模板添加后不显示问题求助

我之前也碰到过一模一样的问题，折腾了好一阵才搞定，给你几个关键排查点：

1. 先盯紧ReportProjectItems.vsdir的格式，这是重灾区 #

你添加的新行必须严格遵循VS的模板定义格式，差一点都不行。正确的格式应该是这样：

[模板显示名称]|[图标文件名]|[RDL模板文件名]|[排序序号]|[模板描述]|[SSRS项目GUID]|[是否隐藏]

给你个可以直接参考的示例：

My Branded Report|MyBrandedReport.ico|MyBrandedReport.rdl|10|A custom report template with my company styles|{10330050-8E2D-4D43-94DE-669D7CB93D99}|0

这里要注意几个细节：

• 图标和RDL文件如果和vsdir在同目录，直接写文件名就行，不用绝对路径
• 那个SSRS项目的GUID{10330050-8E2D-4D43-94DE-669D7CB93D99}必须完全一致，不能写错
• 排序序号数字越小，模板在列表里的位置越靠前
• 最后一位0代表显示模板，1是隐藏，别搞反了

2. 权限！权限！权限！ #

你操作的C:\Program Files (x86)\...路径是系统保护目录，普通用户权限下修改文件可能看似成功，实际根本没写入。解决方法：

• 右键Visual Studio，选择「以管理员身份运行」，然后重新复制RDL、ICO文件，再修改vsdir
• 或者直接给ReportProject文件夹右键→属性→安全，给当前用户添加「完全控制」权限

3. 检查RDL文件的版本兼容性 #

SSDT 2017只支持RDL 2016/2017版本，也就是RDL开头的命名空间是http://schemas.microsoft.com/sqlserver/reporting/2016/01/reportdefinition。如果你的RDL是更高版本（比如2019及以后），VS根本不会把它识别为可用模板。
打开你的RDL文件，看最顶部的<Report>标签的xmlns属性，确认是这个命名空间。

4. 清理VS的缓存，让它重新扫描模板 #

VS会缓存模板列表，有时候你改了文件它还读旧数据。操作步骤：

• 关掉所有VS窗口
• 删除这两个目录里的所有内容：
  • %LocalAppData%\Microsoft\VisualStudio\15.0_<你的VS唯一标识>\ComponentModelCache
  • %LocalAppData%\Microsoft\VisualStudio\15.0_<你的VS唯一标识>\Temp
    （那个唯一标识是一串随机字符，找带15.0的文件夹就行）
• 重启VS再试

5. 换个路径放模板（备用方案） #

如果上面的方法都不行，试试把模板放到用户目录的模板文件夹里，这个路径不需要管理员权限，VS肯定会扫描：
%USERPROFILE%\Documents\Visual Studio 2017\Templates\ReportProjectTemplates
把你的RDL和ICO直接丢进去，不用改vsdir，重启VS就能看到了。

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