Kestrel(net5.0-windows)配置后无法显示.git目录与.gitignore文件

问题原因 #

Windows系统中，.git文件夹和.gitignore文件默认被标记为隐藏属性，而ASP.NET Core的PhysicalFileProvider默认会过滤掉隐藏文件和文件夹，导致目录浏览器无法加载并显示这些内容。

解决方案 #

需要自定义文件提供器，让它强制包含隐藏文件和文件夹，具体实现步骤如下：

1. 实现自定义IFileProvider包装类 #

创建一个包装PhysicalFileProvider的类，重写目录内容的获取逻辑，主动包含隐藏项：

public class HiddenFilesIncludingFileProvider : IFileProvider
{
    private readonly PhysicalFileProvider _innerProvider;

    public HiddenFilesIncludingFileProvider(string root)
    {
        _innerProvider = new PhysicalFileProvider(root);
    }

    public IDirectoryContents GetDirectoryContents(string subpath)
    {
        var contents = _innerProvider.GetDirectoryContents(subpath);
        if (!contents.Exists)
            return contents;

        var fullPath = Path.Combine(_innerProvider.Root, subpath);
        var directoryInfo = new DirectoryInfo(fullPath);
        
        // 获取所有文件（包括隐藏文件）
        var files = directoryInfo.GetFiles("*", SearchOption.TopDirectoryOnly)
            .Select(f => new PhysicalFileInfo(f))
            .Cast<IFileInfo>();
        // 获取所有文件夹（包括隐藏文件夹）
        var directories = directoryInfo.GetDirectories("*", SearchOption.TopDirectoryOnly)
            .Select(d => new PhysicalDirectoryInfo(d))
            .Cast<IFileInfo>();

        return new EnumerableDirectoryContents(files.Concat(directories));
    }

    public IFileInfo GetFileInfo(string subpath)
    {
        return _innerProvider.GetFileInfo(subpath);
    }

    public IChangeToken Watch(string filter)
    {
        return _innerProvider.Watch(filter);
    }
}

2. 替换原有文件提供器配置 #

在项目的Startup/Program.cs中，把原来的PhysicalFileProvider替换成自定义的HiddenFilesIncludingFileProvider：

services.AddDirectoryBrowser();

var requestPath = "";
// 使用自定义文件提供器替代默认实现
var fileProvider = new HiddenFilesIncludingFileProvider(@"D:\MyGitRepo");

app.UseStaticFiles(new StaticFileOptions 
{ 
    FileProvider = fileProvider, 
    RequestPath = requestPath, 
    ServeUnknownFileTypes = true 
});
app.UseDirectoryBrowser(new DirectoryBrowserOptions 
{ 
    FileProvider = fileProvider, 
    RequestPath = requestPath 
});

.UseWebRoot(@"D:\MyGitRepo")
.UseContentRoot(@"D:\MyGitRepo")

3. 注意事项 #

• 暴露.git文件夹存在安全风险，建议仅在本地开发环境中使用该配置，不要部署到生产服务器。
• 已设置的ServeUnknownFileTypes = true会确保.gitignore这类无扩展名的文件可以被正常访问。

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