如何在dotnet new模板中成功执行PostAction脚本？

1. 校验template.json的postActions配置 #

确保template.json里的postActions节点配置完全符合规范，重点关注以下细节：

• 必须将actionId设为2（代表执行外部脚本的类型）
• scriptPath或args中的脚本路径是相对于模板根目录的相对路径，示例配置如下：

  "postActions": [
    {
      "id": "GenerateNewFile",
      "description": "Create new.txt in project root",
      "actionId": "2",
      "args": ["GenerateNewFile.cmd"],
      "continueOnError": false,
      "runOnce": true
    }
  ]
  

• 确认脚本文件名和配置中的名称完全一致（注意跨平台场景下的大小写敏感问题）

2. 确保脚本被纳入模板包 #

打包模板时，要保证GenerateNewFile.cmd没有被排除在模板资源外：

• 检查template.json的sources节点，不要将脚本所在路径加入exclude列表：

  "sources": [
    {
      "modifiers": [
        {
          "exclude": [
            "**/bin/**",
            "**/obj/**"
            // 请勿添加脚本文件的排除规则
          ]
        }
      ]
    }
  ]
  

• 重新打包并更新模板：

  dotnet pack
  dotnet new install <你的模板包路径>
  

3. 修正脚本的路径逻辑 #

模板执行PostAction时，工作目录是生成后的项目根目录，脚本中不要使用相对于自身位置的路径。例如GenerateNewFile.cmd的内容应直接写：

echo. > new.txt

避免使用..\new.txt这类相对脚本位置的路径，因为脚本会被复制到临时目录执行，而非模板原位置。

4. 查看诊断日志定位问题 #

执行模板生成时添加详细日志参数，排查脚本是否被调用或存在报错：

dotnet new <你的模板名称> -v diag

在日志中搜索postActions关键词，查看是否有脚本执行记录、路径错误或权限相关的报错信息。

5. 检查权限与交互设置 #

• 若配置了requiresConfirmation: true，生成时需要手动确认执行脚本，若未确认则会跳过；建议设为false自动执行
• Windows环境下，确保终端有项目生成目录的写入权限，避免不必要的管理员权限运行终端

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