Blazor 6.0发布无index.html，无法部署至GitHub Pages

核心原因 #

你当前的Blazor WASM项目大概率是ASP.NET Core托管模式，这种模式下dotnet publish默认会生成服务器端部署文件，客户端的静态资源（包括index.html）不会直接输出到根目录的wwwroot中。

解决方案 #

1. 单独发布客户端项目（针对托管模式） #

如果你的项目是分Server和Client的解决方案结构：

• 切换到Client项目的根目录（比如执行cd BlazorApp.Client）
• 运行发布命令：dotnet publish -c Release
• 此时bin/Release/netX.0/publish/wwwroot目录里会包含index.html，直接将该wwwroot下的所有文件部署到GitHub Pages即可。

2. 切换为独立Blazor WASM模式（非托管） #

如果不需要ASP.NET Core后端支持，可直接使用独立模式的项目：

• 新建项目时选择「Blazor WebAssembly App」，并取消勾选「ASP.NET Core托管」选项
• 执行dotnet publish -c Release后，bin/Release/netX.0/publish/wwwroot里会自动生成index.html

3. 修改项目配置强制生成静态文件 #

若要保留托管模式但需要静态输出，在Client项目的.csproj文件中添加或修改以下配置：

<PropertyGroup>
  <!-- 替换为你的GitHub仓库名称，适配Pages的基础路径 -->
  <StaticWebAssetBasePath>/your-repo-name/</StaticWebAssetBasePath>
  <PublishDir>./publish</PublishDir>
  <WebPublishMethod>FileSystem</WebPublishMethod>
</PropertyGroup>

之后进入Client目录执行dotnet publish -c Release，生成的publish/wwwroot中会包含index.html。

4. 临时补救：手动复制index.html #

如果上述方法暂时无法生效，可直接从项目源码的wwwroot目录复制index.html到发布后的wwwroot文件夹，再部署到GitHub Pages。

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