VSCode调试Azure Functions的核心前提是Core Tools必须正确安装且版本匹配（如≥4.40），否则断点不命中或调试器退出；需通过命令面板更新Core Tools、确认func --version输出正常、配置launch.json并手动启动func start，再启动VSCode调试会话。
VSCode 调试 Azure Functions 的核心前提是本地运行时（Core Tools）必须就位且版本匹配，否则断点不命中、调试器直接退出是常态。
确认 Core Tools 已正确安装并可被 VSCode 识别
VSCode 的 Azure Functions 扩展依赖 func 命令行工具启动本地函数宿主。如果 func --version 报错或版本过旧（如低于 v4.40），调试必然失败。
- 在 VSCode 中按
F1，输入并执行Azure Functions: Install or update Core Tools—— 这会尝试用 npm/Homebrew 安装最新稳定版；若失败，需手动下载对应平台的二进制包并加入PATH - 打开终端，运行
func --version，确认输出类似4.47.2（2026 年主流支持版本） - 检查项目根目录是否存在
local.settings.json，且其中Values.AzureWebJobsStorage至少设为UseDevelopmentStorage=true（开发环境必需）
HTTP 触发函数的调试配置必须显式启用端口监听
默认 func start 启动后只响应 HTTP 请求，但 VSCode 的调试器需要附加到进程。光靠“运行 > Start Debugging”不会自动触发调试会话，必须配好 launch.json。
- 在项目根目录下确保存在
.vscode/launch.json，内容应包含configurations下的Attach to .NET Functions（C#）或Attach to Python Functions（Python）等语言对应项 - 对 JavaScript/TypeScript：配置中
port必须与func start实际监听端口一致，默认是9229，但某些 Core Tools 版本会动态分配，此时需在launch.json中设"port": 9229并加"autoAttachChildProcesses": true - 启动调试前，先在终端手动运行
func start --language-worker --inspect=9229（Node.js）或func start --dotnet-isolated（.NET 6+ 隔离模式），再点 VSCode 的 ▶️ 按钮
断点不生效？检查函数运行模式与语言 worker 是否对齐
Core Tools 对不同语言的调试支持差异很大。比如 Python 函数若用 func start 直接运行，默认走预编译模式，VSCode 无法注入调试器。
- Python 项目必须确保
host.json中extensionBundle版本 ≥[3.*, 4.0.0)，且python -m pip install azure-functions版本 ≥1.18.0 - C# 项目若使用 .NET 6+，
local.settings.json中需设"AzureWebJobsFeatureFlags": "EnableWorkerIndexing"，否则断点仅在启动时有效 - JavaScript 项目禁用
node_modules/.bin/func，必须用全局安装的func，否则调试器找不到源映射（source map）
调试时函数抛出 System.InvalidOperationException: Unable to resolve service for type 'Microsoft.Azure.WebJobs.Hosting.IWebJobsBuilder'
这是典型的 Core Tools 与扩展版本错配错误，多见于升级 VSCode 或 Azure Functions 扩展后未同步更新 Core Tools。
- 删除项目根目录下的
workers文件夹和bin/obj（C#）或__pycache__（Python）缓存目录 - 关闭所有 VSCode 窗口，清空
~/.azure-functions-core-tools/Functions缓存目录（macOS/Linux）或%USERPROFILE%\AppData\Roaming\Functions（Windows） - 重新执行
Azure Functions: Install or update Core Tools，重启 VSCode，再创建新调试会话
真正卡住调试的，往往不是代码逻辑，而是 func 进程没起来、端口被占、或者 VSCode 找不到正确的 language worker 进程。每次调试前花 30 秒验证 func --version 和 func start 是否能干净输出，比反复重装扩展更有效。
