VSIX模板参数替换异常排查：C# .NET 8可执行项目模板问题

• 检查文件编码：把DependencyInjection.cs转成UTF-8无BOM格式。带BOM的UTF-8会让VS模板引擎解析出错，直接导致参数被拆得乱七八糟。用记事本打开文件，另存为时选“UTF-8（无BOM）”就行。

• 确保项目层面开启参数替换：光给单个ProjectItem设ReplaceParameters="true"不够，得给vstemplate里的<Project>节点也加上这个属性。因为$rootnamespace$这类参数是基于项目上下文的，项目层面不开启的话，单个文件的替换会出问题。示例：

  <Project TargetFileName="YourTemplateProject.csproj" File="YourTemplateProject.csproj" ReplaceParameters="true">
  

• 检查参数格式是否正确：打开DependencyInjection.cs，确认$rootnamespace$是完整连续的，别被空格、注释或者换行拆成两半。比如不能写成$root namespace$或者$rootnamespace（缺了结尾的$），模板引擎只认完整的$参数名$格式。

• 确认ProjectItem节点的位置：<ProjectItem>必须放在<TemplateContent>下的<Project>节点内部，不能放在外面。放外面的话，文件没法获取项目的参数上下文，替换自然会乱。正确结构参考：

  <TemplateContent>
    <Project File="YourTemplate.csproj" ReplaceParameters="true">
      <ProjectItem ReplaceParameters="true" TargetFileName="DependencyInjection.cs">DependencyInjection.cs</ProjectItem>
      <!-- 其他项目文件节点 -->
    </Project>
  </TemplateContent>
  

• 清理缓存重新生成：VS有时候会缓存旧的模板内容，先右键VSIX项目点“清理”，再重新生成，然后卸载旧模板、安装新生成的VSIX包再测试。

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