为现有MVC项目添加CSS文件后样式不生效的问题求助

• 静态资源目录配置错误（最常见） #

ASP.NET MVC / ASP.NET Core MVC 默认仅允许访问wwwroot目录下的静态文件，如果你直接把Style文件夹建在项目根目录而非wwwroot内，默认无法被外部访问。
解决方案两种二选一：

1. 将Style文件夹移动到wwwroot目录下，引用路径保持不变即可
2. 若要保留根目录的Style文件夹，需额外配置静态文件中间件，ASP.NET Core 示例代码如下：

// Program.cs 中，在 app.UseRouting() 之前添加如下配置
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(
        Path.Combine(builder.Environment.ContentRootPath, "Style")),
    RequestPath = "/Style"
});

• 路径访问错误 #

打开浏览器按F12切换到「网络」面板，刷新页面后查看StyleSheet.css的请求状态：

• 如果返回404，说明路径匹配错误，可先直接在浏览器地址栏拼接CSS文件的绝对路径测试是否能访问到文件内容
• 注意引用代码里的路径大小写，部分部署环境（如Linux）的文件路径是大小写敏感的

• 样式被覆盖 #

在浏览器开发者工具的「元素」面板选中body标签，查看你写的background-color: green规则是否被更高优先级的CSS规则覆盖（规则被划掉即为被覆盖），可临时在样式后加!important测试是否是优先级问题：background-color: green !important;

• 浏览器缓存问题 #

按Ctrl + F5强制刷新页面清空缓存，或在开发者工具的「网络」面板勾选「禁用缓存」后再刷新测试

• 静态资源访问权限限制 #

如果是旧版ASP.NET MVC，检查Web.config中是否存在禁止访问Style目录的配置规则，确保静态文件的访问权限已开通

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