ASP.NET拉取GitHub代码后wwwroot文件夹无法识别的解决求助

通常情况下，wwwroot文件夹在Visual Studio中显示为蓝色圆形图标，但从GitHub拉取代码后，该文件夹变为默认黄色图标。此时无法选择“HTTPS”运行选项，仅能以.csproj文件方式运行，且运行时会提示WwwRootPath对应的文件夹不存在。

此前通过多次点击并重新打开项目（耗时近一小时）可修复该问题，但现在此方法已失效。

Program.cs 代码 #

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);

        // Add services to the container.
        var connectionString = builder.Configuration.GetConnectionString("DefaultConnection") ?? throw new InvalidOperationException("Connection string 'DefaultConnection' not found.");
        builder.Services.AddDbContext<ApplicationDbContext>(options =>
            options.UseSqlServer(connectionString));
        builder.Services.AddDatabaseDeveloperPageExceptionFilter();

        builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
            .AddEntityFrameworkStores<ApplicationDbContext>();
        builder.Services.AddControllersWithViews();

        var app = builder.Build();

        // Configure the HTTP request pipeline.
        if (app.Environment.IsDevelopment())
        {
            app.UseMigrationsEndPoint();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseAuthorization();

        app.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
        app.MapRazorPages();

        app.Run();
    }
}

.csproj 文件内容 #

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <UserSecretsId>[not sure that I should share this, but it exists.]</UserSecretsId>
    <RootNamespace>aspNetApp</RootNamespace>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="8.0.11" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="8.0.11" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="8.0.11" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.11" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.11" />
  </ItemGroup>

</Project>

运行时提示信息 #

提示信息1 #

warn: Microsoft.AspNetCore.StaticFiles.StaticFileMiddleware[16]
The WebRootPath was not found: [the path]. Static files may be unavailable.
info: Microsoft.Hosting.Lifetime[0]
Content root path: ...\bin\Release\net8.0

信息中的路径指向Release\net8.0文件夹，而wwwroot默认位于项目根目录。将wwwroot复制到该路径后仍无法解决错误。

提示信息2 #

info: Microsoft.Hosting.Lifetime[14]
Now listening on: http://localhost:5000
info: Microsoft.Hosting.Lifetime[0]
Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
Content root path: C:\Users\Aleksa\source\repos\aspNetApp\bin\Debug\net8.0

无错误提示，但程序无法正常运行。

解决方案 #

快速修复 #

• 卸载并重新加载项目：右键项目 → 选择“卸载项目”，再次右键 → “重新加载项目”。此操作能快速修复图标异常和运行选项问题。
• 切换运行配置：点击Visual Studio顶部的运行下拉框，确认选择的是项目名称而非.csproj文件，切换后即可看到HTTPS运行选项。
• 手动指定WebRootPath：在Program.cs中WebApplication.CreateBuilder(args)后添加代码，强制指定wwwroot路径：

  builder.WebHost.UseWebRoot(Path.Combine(Directory.GetCurrentDirectory(), "wwwroot"));
  

• 清理重建项目：点击顶部菜单“生成” → “清理解决方案”，再执行“生成解决方案”，之后尝试运行。

彻底避免问题复发 #

• 确保仓库文件完整：检查GitHub仓库是否包含wwwroot文件夹及所有内容，拉取代码后确认文件夹未缺失，若缺失则手动创建或恢复。
• 显式配置Web根目录：在.csproj的<PropertyGroup>节点中添加以下配置，明确指定Web根目录：

  <WebRoot>wwwroot</WebRoot>
  

• 配置开发环境变量：在调试配置中设置ASPNETCORE_ENVIRONMENT=Development，避免程序以Production环境启动导致路径识别异常。
• 重置VS用户设置：若问题频繁出现，可通过“工具 → 导入和导出设置 → 重置所有设置”恢复Visual Studio默认配置。

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