Blazor Razor页面通过Add as Link添加的图片不显示如何解决

你遗漏了链接文件到Web根路径的显式映射配置。ASP.NET Core/Blazor的静态文件中间件默认不会自动识别通过「Add as Link」加入项目的虚拟文件，哪怕你设置了生成操作是Content、始终复制到输出目录、bin目录下确实存在对应文件，只要没有在项目配置里显式声明这些链接文件属于wwwroot静态资源路径，静态文件中间件就不会响应对应路径的资源请求，最终img标签加载空白。

• 打开项目的.csproj文件，找到你之前添加的链接文件对应<Content>节点，补全正确的Link属性，确保路径以wwwroot开头，示例配置如下：

<ItemGroup>
  <!-- 替换成你实际的共享源文件路径、wwwroot下的目标存放路径 -->
  <Content Include="..\你的共享文件夹路径\images\*.png">
    <Link>wwwroot\assets\images\%(Filename)%(Extension)</Link>
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
  </Content>
</ItemGroup>

很多人在VS可视化界面操作添加链接到wwwroot下的目录时，会出现Link属性没有自动带上wwwroot前缀的问题，这是最常见的诱因。

• 检查Program.cs中的中间件顺序，确认app.UseStaticFiles()的调用位置在路由、授权、Blazor路由映射中间件之前，避免静态资源请求被其他中间件拦截。
• 如果你用的是独立部署的Blazor WebAssembly项目，需要在.csproj的<PropertyGroup>节点下额外加一行配置，允许构建流程识别链接形式的静态资源：

<_BlazorStaticWebAssetsIncludeLinkedFiles>true</_BlazorStaticWebAssetsIncludeLinkedFiles>

重新生成项目后，直接在浏览器访问https://你的应用域名/assets/images/具体图片文件名.png，如果能直接打开图片，说明配置生效，原有Razor页面里的<img src="assets/images/xxx.png">不需要修改路径，就能正常加载显示。

避坑提示：不要只靠VS属性面板设置链接文件的生成规则，一定要手动打开csproj确认Link节点的路径是否正确，可视化界面的配置经常不会同步生成正确的Link路径值。

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