ASP.NET Core 中的静态文件中间件如何配置？

来源：这里教程网时间：2026-02-21 17:26:57 作者：

在 ASP.NET Core 中，静态文件中间件用于提供 HTML、CSS、JavaScript、图片等静态资源。要启用并配置该中间件，需在 Program.cs 中进行设置。

启用静态文件支持

默认情况下，ASP.NET Core 不自动提供静态文件。需要调用

UseStaticFiles

方法来启用：

app.UseStaticFiles();

这将允许中间件从项目的 wwwroot 目录提供静态文件。例如，访问

/images/logo.png

会映射到

wwwroot/images/logo.png

。

自定义静态文件目录

若想从其他目录提供静态文件，可配置自定义文件提供程序。例如，从

MyPublicFiles

目录提供内容：

var fileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(), "MyPublicFiles")); app.UseStaticFiles(new StaticFileOptions { FileProvider = fileProvider, RequestPath = "/StaticFiles" });

此时可通过

/StaticFiles/example.html

访问

MyPublicFiles/example.html

。

启用目录浏览（谨慎使用）

若需列出目录内容，先在

Program.cs

添加服务：

builder.Services.AddDirectoryBrowser();

然后在中间件管道中启用：

app.UseDirectoryBrowser(new DirectoryBrowserOptions { FileProvider = new PhysicalFileProvider( Path.Combine(Directory.GetCurrentDirectory(), "MyPublicFiles")), RequestPath = "/StaticFiles" });

注意：目录浏览可能带来安全风险，建议仅在开发环境开启。