发布ASP.NET Core项目前如何关联Task Runner运行Webpack脚本

以下提供两种可落地的配置方式，按需选择即可：

方案1：直接修改pubxml配置（推荐，不依赖Task Runner） #

发布流程由MSBuild驱动，直接在发布配置文件中添加执行逻辑是最稳定的方式，不会受VS插件加载异常影响：

• 打开项目下Properties\PublishProfiles目录中你正在使用的.pubxml发布配置文件
• 在文件末尾的</Project>闭合标签之前，插入以下配置：

<Target Name="ExecuteWebpackProdBeforePublish" BeforeTargets="PrepareForPublish">
  <Exec Command="npm run prod" WorkingDirectory="$(ProjectDir)" />
</Target>

• 参数说明：
  • BeforeTargets="PrepareForPublish" 指定该逻辑在发布流程的文件收集阶段之前执行，确保webpack生成的压缩文件能被包含到发布包中
  • WorkingDirectory="$(ProjectDir)" 保证npm命令在项目根目录（package.json所在目录）执行，若package.json存放在子目录，自行修改对应路径即可
  • npm run prod 对应你在package.json的scripts中配置的webpack生产构建命令，脚本名和你自己的配置保持一致即可

方案2：结合Task Runner绑定（适合需要适配本地开发流程的场景） #

如果你需要同时在本地构建和发布时都触发webpack脚本，可以用该方式：

• 打开VS 2019的Task Runner Explorer（入口：视图>其他窗口>Task Runner Explorer）
• 找到你配置的webpack生产构建脚本，右键选择绑定 > Before Build，即可在每次项目构建前执行该脚本
• 注意：若你不需要每次本地调试构建都跑webpack，仅想在发布时触发，优先选择方案1即可，避免本地构建耗时过长

常见问题排查 #

• 若提示找不到npm命令：可以将Command的值替换为npm的绝对路径，Windows默认路径为"C:\Program Files\nodejs\npm.cmd" run prod，也可以将nodejs安装目录添加到系统环境变量后重启VS
• 若webpack生成的文件没有被发布到目标目录：在项目的.csproj文件中添加以下配置，自动包含wwwroot下的所有生成文件：

<ItemGroup>
  <Content Include="wwwroot\**" CopyToPublishDirectory="PreserveNewest" />
</ItemGroup>

• 若需要针对不同发布环境执行不同webpack脚本：不同环境的pubxml文件分别配置对应的npm run [脚本名]即可，比如测试环境配置为npm run test，生产环境配置为npm run prod

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