VS Code按F5调试Azure Function App的运行逻辑及Swagger差异咨询

一、按F5启动调试时VS Code实际运行内容 #

按F5启动调试时，VS Code会按以下流程执行：

1. 读取初始化项目时自动生成的.vscode/launch.json调试配置，该配置会关联并触发tasks.json中最后一个类型为func的host start任务。
2. 由于这个func host start任务依赖build (functions)，因此会先依次执行clean (functions)和build (functions)，完成项目的清理与编译。
3. 启动Azure Functions Host时，会额外附加调试专属参数（如开启调试端口、允许调试器附加），支持断点调试函数代码。

简单来说：F5会执行tasks里的编译任务和host start任务，但会添加调试相关配置。

二、F5显示Swagger而直接运行host start不显示的原因 #

核心差异在于环境变量的设置：

• 你的函数项目中，Swagger的启用逻辑通常通过环境判断实现（比如在Program.cs中用builder.Environment.IsDevelopment()做条件判断），仅在开发环境下加载Swagger中间件。
• 按F5调试时，VS Code的调试配置会自动设置ASPNETCORE_ENVIRONMENT=Development环境变量，触发Swagger启用逻辑，因此会显示Swagger UI端点。
• 直接运行host start任务时，默认不会设置该环境变量，函数宿主默认运行在Production环境，Swagger不会被启用。

如果想让直接运行host start也显示Swagger，可以修改tasks.json中的func任务，添加环境变量配置：

{
    "type": "func",
    "dependsOn": "build (functions)",
    "options": {
        "cwd": "${workspaceFolder}/AssetGovernance/bin/Debug/net8.0"
    },
    "command": "host start",
    "isBackground": true,
    "problemMatcher": "$func-dotnet-watch",
    "env": {
        "ASPNETCORE_ENVIRONMENT": "Development"
    }
}

附：生成的tasks.json内容 #

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "clean (functions)",
            "command": "dotnet",
            "args": [
                "clean",
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "type": "process",
            "problemMatcher": "$msCompile",
            "options": {
                "cwd": "${workspaceFolder}/AssetGovernance"
            }
        },
        {
            "label": "build (functions)",
            "command": "dotnet",
            "args": [
                "build",
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "type": "process",
            "dependsOn": "clean (functions)",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": "$msCompile",
            "options": {
                "cwd": "${workspaceFolder}/AssetGovernance"
            }
        },
        {
            "label": "clean release (functions)",
            "command": "dotnet",
            "args": [
                "clean",
                "--configuration",
                "Release",
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "type": "process",
            "problemMatcher": "$msCompile",
            "options": {
                "cwd": "${workspaceFolder}/AssetGovernance"
            }
        },
        {
            "label": "publish (functions)",
            "command": "dotnet",
            "args": [
                "publish",
                "--configuration",
                "Release",
                "/property:GenerateFullPaths=true",
                "/consoleloggerparameters:NoSummary"
            ],
            "type": "process",
            "dependsOn": "clean release (functions)",
            "problemMatcher": "$msCompile",
            "options": {
                "cwd": "${workspaceFolder}/AssetGovernance"
            }
        },
        {
            "type": "func",
            "dependsOn": "build (functions)",
            "options": {
                "cwd": "${workspaceFolder}/AssetGovernance/bin/Debug/net8.0"
            },
            "command": "host start",
            "isBackground": true,
            "problemMatcher": "$func-dotnet-watch"
        }
    ]
}

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