在Ubuntu系统VSCodium中用netcoredbg调试dotnet core MVC应用如何命中断点？

前置验证 #

先确认环境基础配置正常：

• netcoredbg已正确添加到系统PATH，控制台执行netcoredbg --version可正常返回版本号
• VS Code已安装C#扩展（或C# Dev Kit）

1. 配置tasks.json #

该文件负责调试前自动编译项目，生成带调试符号的二进制文件，是断点命中的必要前提。
在.vscode目录下新建/编辑tasks.json，内容如下：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build",
            "command": "dotnet",
            "type": "process",
            "args": [
                "build",
                "${workspaceFolder}/<你的MVC项目名>.csproj", // 替换为你实际的.csproj路径
                "--configuration",
                "Debug", // 必须用Debug配置才会生成调试符号
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "problemMatcher": "$msCompile",
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

2. 配置launch.json #

该文件负责配置netcoredbg调试器的启动参数，直接影响断点加载逻辑。
在.vscode目录下新建/编辑launch.json，内容如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core MVC (netcoredbg)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build", // 对应tasks.json里的build任务，调试前自动编译
            "program": "${workspaceFolder}/bin/Debug/net<你的.NET版本号>/<你的MVC项目名>.dll", // 替换为你实际生成的dll路径
            "args": [],
            "cwd": "${workspaceFolder}", // 必须是项目根目录，即appsettings.json所在目录
            "stopAtEntry": false,
            "serverReadyAction": {
                "action": "openExternally",
                "pattern": "\\bNow listening on:\\s+(https?://\\S+)" // 启动后自动打开浏览器访问MVC站点
            },
            "env": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            },
            "justMyCode": true, // 只加载用户代码的调试符号，避免框架代码干扰
            "symbolOptions": {
                "searchPaths": [],
                "searchMicrosoftSymbolServer": false,
                "searchNuGetOrgSymbolServer": false
            }
        }
    ]
}

注意替换配置里的占位符：<你的MVC项目名>替换为实际项目名，<你的.NET版本号>替换为你使用的.NET版本，比如net6.0、net7.0

3. 常见问题排查 #

• 调试前清理残留进程：执行ps aux | grep dotnet查询所有dotnet进程，用kill -9 <进程ID>杀掉残留进程，避免旧版本代码运行导致断点失效
• 确认项目调试符号配置：打开.csproj文件，确认PropertyGroup节点下没有<DebugType>None</DebugType>配置，跨平台调试需要用<DebugType>Portable</DebugType>（默认Debug配置已开启）
• 不要使用Release编译产物调试，Release版本会做代码优化，调试符号会被裁剪，无法命中任何断点

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