ASP.NET 6项目VS Code调试时无法识别wwwroot目录的解决方法

以下是针对该场景的排查和解决步骤：

• 检查VS Code调试配置（launch.json）
  打开.vscode/launch.json，确保cwd属性指向你的项目根目录（即包含wwwroot和.csproj文件的目录）。示例配置：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": ".NET Core Launch (web)",
              "type": "coreclr",
              "request": "launch",
              "preLaunchTask": "build",
              "program": "${workspaceFolder}/bin/Debug/net6.0/YourProjectName.dll",
              "args": [],
              "cwd": "${workspaceFolder}", // 确保此处为项目根目录
              "stopAtEntry": false,
              "serverReadyAction": {
                  "action": "openExternally",
                  "pattern": "\\bNow listening on:\\s+(https?://\\S+)"
              },
              "env": {
                  "ASPNETCORE_ENVIRONMENT": "Development"
              },
              "sourceFileMap": {
                  "/Views": "${workspaceFolder}/Views"
              }
          }
      ]
  }
  

  若cwd设置错误，程序会从错误目录寻找wwwroot，导致资源无法加载。

• 确保终端运行dotnet run的目录正确
  在VS Code终端中，切换到.csproj文件所在的项目目录，再执行dotnet run。如果在解决方案根目录（而非项目目录）运行命令，ASP.NET将无法找到当前目录下的wwwroot文件夹。

• 验证页面路径的解析方式
  页面中使用的~/是ASP.NET虚拟路径标记，需确保被正确解析：

  • 若为Razor页面/视图，在_ViewImports.cshtml中启用Tag Helper：

    @addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
    

  • 随后将资源引用改为Tag Helper格式，例如：

    <link rel="stylesheet" href="~/lib/css/site.css" asp-append-version="true" />
    <script src="~/lib/js/site.js"></script>
    

  直接使用~/路径而不借助Tag Helper或Url.Content()，部分场景下无法被正确转换为实际路径。

• 确认静态文件中间件的顺序
  检查Program.cs中中间件的注册顺序，UseStaticFiles()必须在路由和授权中间件之前注册，正确顺序示例：

  var builder = WebApplication.CreateBuilder(args);
  
  // 添加所需服务（如Razor Pages、MVC等）
  builder.Services.AddRazorPages();
  
  var app = builder.Build();
  
  // 开发环境错误处理
  if (!app.Environment.IsDevelopment())
  {
      app.UseExceptionHandler("/Error");
      app.UseHsts();
  }
  
  app.UseHttpsRedirection();
  app.UseStaticFiles(); // 静态文件中间件需放在UseRouting之前
  
  app.UseRouting();
  
  app.UseAuthorization();
  
  app.MapRazorPages(); // 或MapControllerRoute等
  
  app.Run();
  

  若UseStaticFiles()被放在路由之后，静态资源请求可能被路由规则拦截，返回404。

• 检查.csproj文件的静态资源配置
  确保项目文件中包含wwwroot资源的复制规则，默认ASP.NET 6项目会自动生成，若被修改过需确认：

  <ItemGroup>
      <Content Include="wwwroot/**/*" CopyToOutputDirectory="PreserveNewest" />
  </ItemGroup>
  

  该配置会确保wwwroot下的文件被复制到输出目录，程序运行时可正常访问。

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