ASP.NET Core中添加无功能纯HTML页面的方法咨询

嘿，这个问题我太熟悉了！完全没必要给每个纯HTML页面都创建对应的Action方法，ASP.NET Core提供了好几种简单高效的方式来托管静态HTML页面，我给你整理了最常用的几个方案：

方案1：直接利用默认的静态文件目录（最简单） #

ASP.NET Core默认把wwwroot文件夹作为静态文件的托管根目录，你只需要：

• 把所有纯HTML页面直接放到项目的wwwroot文件夹里（可以创建子文件夹分类，比如wwwroot/pages/about.html）
• 确保你的Program.cs里已经添加了静态文件中间件（默认的Web应用模板已经包含这个配置）：

var builder = WebApplication.CreateBuilder(args);
// 其他服务配置...

var app = builder.Build();

// 静态文件中间件要放在路由、授权等中间件之前
app.UseStaticFiles();

// 其他中间件配置（比如路由、MVC等）...

app.Run();

之后你就可以通过URL直接访问这些页面了，比如http://yourdomain/about.html或者http://yourdomain/pages/about.html。

方案2：自定义静态文件目录（灵活分类） #

如果不想把HTML页面混在wwwroot的其他静态资源（比如CSS、JS）里，你可以单独创建一个目录（比如StaticHTMLPages），然后通过配置静态文件中间件来指定这个目录：

var builder = WebApplication.CreateBuilder(args);
// 其他服务配置...

var app = builder.Build();

// 先保留默认的wwwroot静态文件支持
app.UseStaticFiles();

// 添加自定义静态目录的支持
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "StaticHTMLPages")),
    RequestPath = "/static-pages" // 访问前缀
});

// 其他中间件配置...

app.Run();

这样，StaticHTMLPages文件夹里的contact.html，就可以通过http://yourdomain/static-pages/contact.html访问。

方案3：设置默认首页（访问根域名直接打开HTML） #

如果想让某个HTML页面作为应用的默认首页（比如访问http://yourdomain就打开index.html），只需要在UseStaticFiles之前添加UseDefaultFiles中间件：

var app = builder.Build();

// UseDefaultFiles要放在UseStaticFiles前面
app.UseDefaultFiles();
app.UseStaticFiles();

// 其他中间件配置...

app.Run();

它会自动在静态文件目录里查找index.html、default.html、index.htm等命名的文件，作为默认首页。

额外提示 #

• 注意文件路径的大小写：在Windows系统下路径不区分大小写，但在Linux/macOS环境下是严格区分的，所以建议统一用小写命名文件和文件夹。
• 如果需要对某些静态HTML页面做访问权限控制，可以结合授权中间件或者在静态文件配置里添加自定义逻辑，但一般纯静态页面都是公开访问的。

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