Windows下VS Code使用外部终端调试.NET Azure Functions项目的配置问题

数据老陈

2026-9-29

Windows下VS Code外部终端调试.NET Azure Functions 配置方案

attach模式是附加到已经运行的Function Host进程，进程的终端在启动时就已经确定，因此在attach配置里加console: externalTerminal不会生效，必须改用launch模式在进程启动时指定终端类型。

1. 完整launch.json配置

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch .NET Functions (External Terminal)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            // 可执行PowerShell命令 (Get-Command func).Source 查看本地func路径，将后缀exe替换为dll即可
            "program": "${env:APPDATA}\\npm\\node_modules\\azure-functions-core-tools\\bin\\func.dll",
            "args": ["host", "start"],
            "cwd": "${workspaceFolder}",
            "console": "externalTerminal",
            "justMyCode": false,
            "stopAtEntry": false,
            "internalConsoleOptions": "neverOpen"
        }
    ]
}

路径适配说明

若通过Chocolatey安装Azure Functions Core Tools，program路径替换为C:\\ProgramData\\chocolatey\\lib\\azure-functions-core-tools\\tools\\func.dll
若通过其他渠道安装，可在PowerShell执行(Get-Command func).Source获取func.exe路径，将后缀改为dll即可使用

2. 配套tasks.json配置

需确保工作区.vscode目录下的tasks.json存在对应build任务，示例配置如下：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build",
            "command": "dotnet",
            "type": "process",
            "args": [
                "build",
                "${workspaceFolder}/${workspaceFolderBasename}.csproj",
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "problemMatcher": "$msCompile"
        }
    ]
}