如何修正VSCode中Blazor Server的launch.json与tasks.json以启用调试

问题根源 #

当前配置无法调试的核心原因：

• launch.json 主调试配置类型为 msedge，仅支持浏览器前端调试，未配置.NET Core后端调试（Blazor Server核心逻辑运行在服务器端）
• 关键调试关联参数（serverReadyAction、inspectUri）被注释，无法建立调试会话
• tasks.json 用 dotnet watch run 作为预启动任务，与调试流程冲突

修正后的 launch.json #

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Launch (Blazor Server)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/bin/Debug/net8.0/BlazorStore9.dll",
            "args": [],
            "cwd": "${workspaceFolder}",
            "stopAtEntry": false,
            "serverReadyAction": {
                "action": "openExternally",
                "pattern": "\\bNow listening on:\\s+(https?://\\S+)"
            },
            "env": {
                "ASPNETCORE_ENVIRONMENT": "Development",
                "ASPNETCORE_URLS": "http://localhost:5000"
            },
            "sourceFileMap": {
                "/Views": "${workspaceFolder}/Views"
            }
        },
        {
            "name": ".NET Core Attach",
            "type": "coreclr",
            "request": "attach",
            "processId": "${command:pickProcess}"
        },
        {
            "name": "Blazor Browser Debug",
            "type": "msedge",
            "request": "launch",
            "url": "http://localhost:5000",
            "webRoot": "${workspaceFolder}/wwwroot",
            "sourceMaps": true,
            "inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}"
        }
    ]
}

核心修改说明： #

1. 主调试配置type改为coreclr，针对.NET Core后端代码调试
2. 指定program路径为项目编译后的DLL文件（替换net8.0为你的实际.NET版本）
3. 启用serverReadyAction，服务器启动后自动打开浏览器
4. 新增独立的浏览器调试配置，用于Razor组件前端代码调试

修正后的 tasks.json #

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build",
            "command": "dotnet",
            "type": "process",
            "args": [
                "build",
                "${workspaceFolder}/BlazorStore9.csproj",
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "problemMatcher": "$msCompile",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "presentation": {
                "reveal": "silent"
            }
        },
        {
            "label": "watch",
            "command": "dotnet",
            "type": "process",
            "args": [
                "watch",
                "run",
                "${workspaceFolder}/BlazorStore9.csproj",
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "problemMatcher": "$msCompile",
            "presentation": {
                "reveal": "silent"
            }
        }
    ]
}

核心修改说明： #

1. 将原build任务的dotnet watch run改为dotnet build，作为调试前的标准编译任务
2. 新增独立的watch任务，用于日常开发的热重载（调试时无需启用）
3. 恢复group配置，将build设为默认构建任务

调试使用方法 #

1. 调试后端代码：选择.NET Core Launch (Blazor Server)启动，可在C#代码中打断点
2. 调试前端代码：先启动后端调试，再选择Blazor Browser Debug，可在Razor组件的前端逻辑中打断点
3. 热重载开发：单独运行watch任务，无需调试时使用

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