Visual Studio 2022自定义项目模板解压重压缩后无法显示

VS2022对自定义项目模板的ZIP包有严格的格式校验，手动解压重压缩后识别失败，基本是以下三类问题导致：

• 压缩包目录层级不符合要求：VS扫描模板包时，只会读取ZIP根目录下的.vstemplate配置文件。绝大多数手动压缩场景下，用户是选中解压生成的外层文件夹直接打包，最终ZIP的第一层是同名文件夹，所有模板文件都嵌套在这个子文件夹里，VS找不到根目录的配置文件就会直接忽略该压缩包。
• 压缩算法/格式不兼容：VS的模板解析模块仅支持标准ZIP 2.0规范的Deflate压缩算法，不兼容Deflate64、LZMA、BZip2等其他压缩算法，也不支持ZIP包内带AES加密、NTFS扩展属性、ZIP64扩展头（哪怕文件体积远小于4GB，部分压缩工具默认开启该特性也会触发识别失败）。Win11系统自带压缩、NanaZip默认配置下都可能使用非兼容的压缩参数，打包出来的文件无法被VS解析。
• 文件元数据/编码损坏：部分压缩工具在重打包过程中，会修改.vstemplateXML配置文件的UTF-8编码格式（比如给无BOM的文件加上BOM，或是反过来转码），或是篡改文件的原始属性标记，导致VS读取配置时校验失败。

• 修正压缩包目录结构：解压原始模板包后，不要直接选中外层文件夹压缩，进入解压得到的文件夹内部，全选所有内容（包含.vstemplate文件、项目文件、源码目录等）后再执行压缩操作。打包完成后打开ZIP校验，确认根目录下直接存在.vstemplate文件，没有多余的嵌套文件夹层级。
• 调整压缩工具参数：不要使用Win11自带的压缩功能打包模板，推荐使用NanaZip/7-Zip，压缩时手动配置参数：
  • 压缩格式选择zip
  • 压缩算法选择Deflate（禁止选择Deflate64、LZMA等其他算法）
  • 关闭加密选项、关闭NTFS文件流/权限存储选项、关闭ZIP64扩展选项
  • 压缩等级选择标准即可，无需使用极限压缩
• 使用VS原生功能导出：最稳定的方案是将修改后的模板项目在VS中打开，重新走Project -> Export Template流程生成模板包，原生导出的文件会自动适配VS的所有校验规则，不会出现识别异常。
• 清理模板缓存触发重载：如果正确放置模板包后仍不显示，先关闭所有VS窗口，删除路径%LOCALAPPDATA%\Microsoft\VisualStudio\17.0_<对应VS实例ID>\ProjectTemplatesCache下的所有缓存文件，重启VS后会触发全量模板扫描，重新加载符合要求的模板。

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