asp-append-version="true"是关键，因LinkTagHelper据此基于文件内容计算SHA256哈希并追加为?v=查询参数，确保内容变更时浏览器强制更新缓存；仅对wwwroot下文件生效，且必须与实际引用的物理文件（如.min.css）严格匹配。
直接用 asp-href-include + asp-append-version="true" 就行，不用手算哈希、不改文件名、不配构建工具。
为什么 asp-append-version="true" 是关键
ASP.NET Core 的 LinkTagHelper 在生成 <link> 标签时，只要启用了 asp-append-version="true"，就会自动基于文件内容计算 SHA256，并把 Base64 编码后的哈希值追加为查询参数（如 ?v=abc123...）。这个值只随文件内容变而变，和修改时间无关。
常见错误是只写 asp-href-include 却漏掉 asp-append-version：
- ❌
<link rel="stylesheet" asp-href-include="/css/site.css">→ 完全没版本号，浏览器可能长期缓存旧版 - ✅
<link rel="stylesheet" asp-href-include="/css/site.css" asp-append-version="true">→ 生成类似/css/site.css?v=J8XzF...的 URL
静态文件必须放在 wwwroot 下才能生效
asp-append-version 依赖 ASP.NET Core 的静态文件发现机制，它只扫描 wwwroot 目录及其子目录。如果 CSS 放在项目根、Content 或其他任意非 wwwroot 路径下，Tag Helper 会静默失败——既不报错，也不加版本号。
立即学习“前端免费学习笔记（深入）”；
确认路径是否合法：
- ✅ 正确位置：
wwwroot/css/site.css（对应asp-href-include="/css/site.css"） - ❌ 错误位置：
css/site.css（不在wwwroot内，Tag Helper 找不到物理文件） - ⚠️ 注意：
asp-href-include的路径是相对于wwwroot的，不是相对于视图文件
合并压缩（.min.css）和指纹不能混用
如果你用 BuildBundlerMinifier 生成了 site.min.css，仍要启用指纹，就必须对 .min.css 文件本身启用 asp-append-version，而不是对源文件（如 site.css）。
原因：框架按请求的 URL 查找物理文件并计算哈希；你引用的是哪个文件，就对哪个文件算指纹。
- ✅ 引用压缩后文件：
asp-href-include="/css/site.min.css" asp-append-version="true" - ❌ 引用源文件但期望压缩版生效：
asp-href-include="/css/site.css" asp-append-version="true"→ 指纹来自未压缩版，且浏览器可能因 MIME 类型或内容差异拒绝缓存 - ⚠️
BuildBundlerMinifier生成的.min.css是独立物理文件，和 Tag Helper 的指纹机制完全解耦，二者可共存但需各自配置到位
最容易被忽略的一点：指纹只在发布（dotnet publish）或开发环境下启用静态文件中间件（app.UseStaticFiles()）后才起作用。如果在自定义中间件中绕过静态文件处理，或禁用了该中间件，asp-append-version 会退化为无操作——它需要底层能读取到文件内容才能算哈希。
