创建支持变量替换的.NET模板遇问题：dotnet pack变量未替换

核心问题根源 #

你按官方教程创建的模板未触发变量替换，但旧的zip方法正常，说明新模板的配置文件缺少变量替换规则声明，或是打包时未正确覆盖需要替换的文件范围。

具体修复步骤 #

1. 检查并完善template.json配置 #

在模板根目录找到template.json（无则新建），确保以下配置项正确：

• 声明变量规则：在symbols节点中定义ext_safeprojectname，关联到根项目名称参数：

"symbols": {
  "ext_safeprojectname": {
    "type": "parameter",
    "datatype": "string",
    "defaultValue": "MyProject",
    "isRequired": true,
    "replaces": "$ext_safeprojectname$",
    "description": "The safe name of the project"
  }
}

• 指定替换文件范围：在sources节点中添加规则，覆盖.csproj和代码文件：

"sources": [
  {
    "modifiers": [
      {
        "replacements": [
          {
            "files": [
              "**/*.csproj",
              "**/*.cs"
            ],
            "rename": false
          }
        ]
      }
    ]
  }
]

多项目场景下，需在projects节点明确子项目路径，确保变量替换渗透到层级引用中：

"projects": [
  {
    "path": "Application",
    "name": "$ext_safeprojectname$.Application"
  },
  {
    "path": "Domain",
    "name": "$ext_safeprojectname$.Domain"
  },
  {
    "path": "Infrastructure",
    "name": "$ext_safeprojectname$.Infrastructure"
  }
]

2. 验证.csproj中的变量写法 #

确保Application层.csproj的ProjectReference路径正确使用变量，示例：

<ProjectReference Include="..\$ext_safeprojectname$.Domain\$ext_safeprojectname$.Domain.csproj" />

注意变量前后的$符号无拼写错误，路径与模板内项目结构匹配。

3. 重新打包安装模板 #

清理旧模板后重新打包安装：

dotnet template uninstall YourTemplateName
dotnet pack
dotnet template install ./bin/Release/YourTemplatePackage.nupkg

打包时确认所有需替换文件已被包含在.nuspec或template.json的sources规则中。

4. 测试模板创建流程 #

创建新项目时，确保正确输入项目名称，触发Visual Studio或dotnet CLI的参数传递，验证变量是否被正常替换。

旧方法正常的原因 #

旧的zip方式直接将文件放入Visual Studio模板文件夹，VS会自动扫描并处理内置变量（如$ext_safeprojectname$）；而新的自定义模板需在template.json中显式配置替换规则，否则变量不会被解析。

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