Azure Functions TypeScript本地VS Code调试（F5）失败求助

1. 检查核心依赖完整性 #

• 确认全局安装Azure Functions Core Tools：执行 func --version 查看版本，低于4.x建议升级，运行 npm install -g azure-functions-core-tools@4 --unsafe-perm true
• 重置本地依赖：删除项目根目录的 node_modules 文件夹和 package-lock.json 文件，重新执行 npm install

2. 验证TypeScript编译配置 #

• 检查 tsconfig.json 中的 outDir 配置，需指向Azure Functions运行时可识别的目录（如dist或bin），确保编译后的JS文件能被正确加载
• 手动执行编译：运行 npm run build，排查并修复所有TypeScript语法、类型错误后再启动函数

3. 核对VS Code插件与配置文件 #

• 更新Azure Functions插件：在VS Code扩展面板中找到Azure Functions插件，点击更新到最新版本
• 检查.vscode目录下的配置文件：
  • launch.json 中program路径需正确指向Core Tools的启动文件（Windows一般为%APPDATA%\npm\node_modules\azure-functions-core-tools\bin\func.js，Mac/Linux为/usr/local/lib/node_modules/azure-functions-core-tools/bin/func.js）
  • tasks.json 需包含npm: build任务，确保函数启动前自动完成TypeScript编译

4. 排查端口与权限问题 #

• 检查默认端口（7071）是否被占用：Windows执行 netstat -ano | findstr :7071，Mac/Linux执行 lsof -i :7071，杀死占用进程后重试
• Windows用户建议以管理员身份运行VS Code，避免因权限不足导致的文件读写或端口绑定失败

5. 校验本地环境配置 #

• 检查 local.settings.json：确认FUNCTIONS_WORKER_RUNTIME设置为node，NODE_ENV设置为development
• 确保该文件JSON格式合法，无引号未闭合、逗号多余等语法错误

若以上步骤仍未解决问题，提供终端输出的具体错误日志内容，可进一步精准定位问题。

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