VS发布Blazor WASM项目时如何自动切换index.html的base路径

方案1：使用官方PathBase参数自动适配（最推荐，.NET 5+支持） #

Blazor WASM原生支持通过构建参数自动调整base路径，无需手动修改文件或自定义逻辑，完美适配开发、发布两个场景：

• 开发调试阶段：保持index.html中base标签为默认的<base href="/" />即可正常运行，无需额外配置。
• 发布阶段：通过指定PathBase参数，发布过程会自动替换base路径为目标值。

Visual Studio图形化发布配置步骤 #

1. 打开你的发布配置页，点击「显示所有设置」
2. 在「构建」选项卡的「附加生成参数」输入框中填入 -p:PathBase=/wwwroot
3. 保存配置后，每次点击发布按钮都会自动将base路径替换为<base href="/wwwroot/" />，不会影响本地调试的配置。

命令行发布配置 #

直接执行以下命令即可完成自动替换和发布：

dotnet publish -c Release -p:PathBase=/wwwroot -o 你的PHP项目wwwroot目录路径

方案2：自定义构建替换任务（适配.NET 5以下旧版本） #

如果你的项目版本较低不支持PathBase参数，可以通过在项目文件中添加发布钩子自动替换：

1. 保持开发用index.html中base标签为<base href="/" />
2. 打开Blazor WASM项目的.csproj工程文件，在Project节点内添加以下内容：

<Target Name="ReplaceBaseHrefOnPublish" BeforeTargets="Publish" Condition="'$(Configuration)' == 'Release'">
  <ReadLinesFromFile File="$(WWWRoot)index.html">
    <Output TaskParameter="Lines" ItemName="IndexLines" />
  </ReadLinesFromFile>
  <WriteLinesToFile 
    File="$(WWWRoot)index.html" 
    Lines="@(IndexLines.Replace('&lt;base href=&quot;/&quot; /&gt;', '&lt;base href=&quot;/wwwroot/&quot; /&gt;'))" 
    Overwrite="true" />
</Target>

保存后每次Release模式发布都会自动替换base路径，Debug调试时不会修改原文件。

方案3：调试阶段统一使用/wwwroot/作为base路径 #

如果你希望开发、发布用相同的base路径，无需切换，按以下步骤配置：

1. 将index.html中的base标签固定为<base href="/wwwroot/" />
2. 打开项目下Properties/launchSettings.json文件，修改启动配置：

{
  "iisSettings": {
    "iisExpress": {
      "applicationUrl": "http://localhost:你本地的端口号/wwwroot",
      "sslPort": 你本地的SSL端口号
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "wwwroot",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

3. 如果你使用本地完整IIS调试，直接在IIS站点中新增名为wwwroot的虚拟目录，指向Blazor项目的wwwroot文件夹即可正常运行。

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