如何让项目模板中的类名与新建项目名称自动同步？

我碰到过好几次这个问题，你已经走对了大部分步骤，但可能漏掉了几个关键细节，我帮你梳理下排查方向：

1. 类文件内容必须替换占位符 #

你改了vstemplate的TargetFileName和csproj配置，但模板里的类文件本身的代码有没有把硬编码的类名换成$safeprojectname$？比如原来的Class1.cs内容应该改成这样：

namespace $safeprojectname$
{
    public class $safeprojectname$
    {
        // 类的逻辑代码
    }
}

要是代码里还是写死的旧类名，就算文件名变了，类本身的名字还是不会自动更新。

2. 给ProjectItem开参数替换开关 #

在vstemplate文件的<ProjectContent>节点下，对应的类文件一定要加上ReplaceParameters="true"属性，告诉VS要处理这个文件里的占位符：

<ProjectContent>
    <ProjectItem ReplaceParameters="true" TargetFileName="$safeprojectname$.cs">Class1.cs</ProjectItem>
</ProjectContent>

没开这个属性的话，VS只会改文件名，不会碰文件内容里的占位符。

3. 打包zip的结构不能错 #

打包模板的时候别犯这个低级错误：不要把整个模板文件夹打包，要把文件夹里的所有文件直接放在zip根目录。比如你的模板文件都在MyAwesomeTemplate文件夹里，选里面的vstemplate、csproj、类文件这些直接压缩，而不是压缩整个MyAwesomeTemplate文件夹。VS找不到根目录下的vstemplate文件，就会忽略所有参数配置。

4. 清理VS的模板缓存 #

VS会缓存旧模板，有时候新模板装了也不生效。你可以这么做：

• 关掉所有VS窗口
• 打开这个路径：%USERPROFILE%\AppData\Roaming\Microsoft\VisualStudio\<你的VS版本号>\ItemTemplatesCache（比如VS2022的版本号是17.0_xxxx）
• 删除对应模板的缓存文件夹，或者直接清空整个缓存目录
• 重新以管理员身份运行devenv /installvstemplates

5. 检查csproj里的文件引用 #

确保csproj里的类文件引用也用了占位符，比如：

<Compile Include="$safeprojectname$.cs" />

要是这里还是旧的文件名，项目可能会找不到新文件，或者类名和文件名不匹配。

6. 重启VS再测试 #

安装完模板后，别在已经打开的VS里直接创建项目，关掉所有VS实例重新打开，再去创建新项目，这样VS才会加载新的模板配置。

按照这些步骤逐一排查，应该就能解决类名不随项目名称变更的问题了。

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