如何调试多项目Blazor Web Assembly中的wasm.core文件

一、手动创建launchSettings.json #

由于项目缺少调试启动配置文件，直接在项目的Properties目录下新建launchSettings.json，粘贴以下内容：

{
  "profiles": {
    "Blazor WASM": {
      "commandName": "Project",
      "dotnetRunMessages": true,
      "launchBrowser": true,
      "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

该文件是启动调试的核心配置，其中inspectUri确保浏览器能连接到WASM调试代理。

二、启用调试符号生成 #

1. 打开项目的.csproj文件，在<PropertyGroup>节点内添加以下配置：

<DebugType>portable</DebugType>
<DebugSymbols>true</DebugSymbols>
<BlazorWebAssemblyEnableDebugging>true</BlazorWebAssemblyEnableDebugging>

这会生成便携调试符号，让浏览器能识别并加载项目源码文件。

2. 清理并重新构建项目，在终端执行命令：

dotnet clean
dotnet build -c Debug

三、启动调试并定位文件 #

1. 用Debug模式启动项目：

dotnet run --project 你的WASM项目路径 --configuration Debug

2. 打开Chrome浏览器访问项目地址（如https://localhost:5001）。
3. 按下Alt + Shift + D，Chrome开发者工具会自动切换到Sources面板，加载WASM调试会话。
4. 在Sources面板左侧，展开file://下的项目源码目录，即可找到wasm.core中的文件，设置断点即可调试。

成功进入调试模式后，你会看到类似以下的界面：

调试wasm.core页面：

调试wasm.core服务：

四、排查常见问题 #

• 若仍看不到文件，检查Chrome开发者工具设置（按F1），确保Enable JavaScript source maps和Enable CSS source maps已勾选。
• 确认项目运行在Debug模式下，Release模式会关闭调试符号生成。

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