如何在ASP.Net Core 5.0项目中添加自定义CSS

• 优先排查选择器优先级冲突
  Razor Pages默认模板会内置bootstrap、默认site.css样式，你写的自定义样式如果选择器权重低于内置样式，或者自定义CSS文件的加载顺序早于内置样式，就会被覆盖。你可以先给对应样式临时加!important验证，如果加后生效，就调整选择器权重，或者调整布局页中CSS文件的加载顺序，把自定义CSS放在所有内置CSS的后面加载即可。
• 排查静态文件缓存问题
  如果项目配置了静态文件缓存规则，浏览器会长期复用本地缓存的旧CSS文件，哪怕你在元素面板看到的样式是最新的。可以先按Ctrl+F5（Windows）/Shift+Cmd+R（Mac）强制刷新清除缓存测试。
  开发阶段建议给CSS引用加上asp-append-version="true"属性，示例如下：

<link rel="stylesheet" href="~/css/your-custom.css" asp-append-version="true" />

该标签助手会自动给CSS路径追加文件哈希值，只要文件内容修改，哈希就会变化，浏览器会自动拉取最新文件，不会走旧缓存。
也可以在开发环境配置静态文件选项直接禁用缓存：

if (env.IsDevelopment())
{
    app.UseStaticFiles(new StaticFileOptions
    {
        OnPrepareResponse = ctx =>
        {
            ctx.Context.Response.Headers["Cache-Control"] = "no-cache, no-store";
        }
    });
}
else
{
    app.UseStaticFiles();
}

• 确认CSS路径引用正确
  检查_Layout.cshtml或者对应页面的CSS引用路径，必须是相对于wwwroot目录的路径，前缀加~/确保根路径匹配，避免相对路径在不同路由下加载失败的问题。
• 验证浏览器加载的CSS内容
  打开浏览器开发者工具的「来源(Sources)」面板，找到对应的自定义CSS文件，确认里面的代码是你修改后的最新版本，如果和本地代码不一致，彻底清除浏览器所有缓存后再重试。

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