.NET 7 Blazor WASM在VS运行时加载/_vs/browserLink报错

基于.NET 7开发的Blazor WebAssembly应用，使用dotnet run命令运行正常，但通过Visual Studio运行时，浏览器控制台出现以下错误：

The script from “https://localhost:5008/_vs/browserLink” was loaded even though its MIME type (“text/html”) is not a valid JavaScript MIME type.
Uncaught SyntaxError: expected expression, got '<'

问题在于应用尝试从/_vs/browserLink加载JS脚本，但该资源不存在。项目中未引用BrowserLink，也未安装相关NuGet包。

1. 是否是Visual Studio自动注入了该脚本？ #

是的，这是Visual Studio的自动行为。即便项目里没引用BrowserLink相关包或配置，只要IDE的BrowserLink功能处于启用状态，启动项目时它就会自动向页面注入该脚本引用。

2. 如何排查失败原因？如何解决或阻止加载？ #

排查方向 #

• 查看Visual Studio右上角的BrowserLink图标（双循环箭头样式），确认功能是否启用。
• 检查项目配置文件：包括.csproj、launchSettings.json、appsettings.json，看是否存在BrowserLinkEnabled这类相关配置项。
• 检查IDE全局设置：进入「工具」->「选项」->「项目和解决方案」->「Web项目」，查看是否有自动启用BrowserLink的设置。

解决/阻止方法 #

• 直接关闭IDE的BrowserLink功能：点击右上角的BrowserLink图标，取消勾选「启用Browser Link」；或者通过上述全局设置路径，取消对应勾选。
• 项目配置强制禁用：在项目的.csproj文件中添加以下配置：

  <PropertyGroup>
    <BrowserLinkEnabled>false</BrowserLinkEnabled>
  </PropertyGroup>
  

  或者在launchSettings.json的对应启动配置里添加环境变量：

  "environmentVariables": {
    "ASPNETCORE_ENVIRONMENT": "Development",
    "ASPNETCORE_BROWSERLINK": "false"
  }
  

• 清理浏览器缓存：缓存的旧脚本引用可能引发问题，清除后重新运行项目即可。

3. BrowserLink与Hot Reload无关？是否需要使用BrowserLink？ #

• 两者是完全独立的功能：Hot Reload是.NET原生的实时代码刷新工具，无需依赖BrowserLink；BrowserLink是Visual Studio专属的多浏览器同步调试工具，功能和实现机制都不一样。
• 是否需要用BrowserLink看你的开发需求：如果不需要多浏览器同步操作、页面加载状态监控这类功能，完全可以禁用它，不会影响项目运行和Hot Reload的正常使用。

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