Macbook M1环境下Python 3.9 Azure函数本地测试报错求助

问题描述 #

在MacBook M1（ARM64架构）设备上使用Python3.9开发Azure函数时，本地测试无法启动，.vscode/tasks.json配置文件中"type": "func"和"problemMatcher": "$func-python-watch"行出现黄色波浪线，导致测试用例无法正常运行。

核心原因 #

M1的ARM64架构与Azure Functions Core Tools、VS Code Azure插件的兼容性不匹配，或是Python环境采用Rosetta转译的x86版本，导致VS Code无法识别task类型和问题匹配器。

解决步骤 #

• 安装ARM64版Azure Functions Core Tools
  卸载原可能为x86架构的工具，重装ARM原生版本：

  brew uninstall azure-functions-core-tools
  brew install azure-functions-core-tools@4 --build-from-source
  

  验证安装：运行func --version，确认输出包含arm64标识且版本为4.x以上。

• 更新VS Code Azure Functions插件并修复tasks.json

  1. 打开VS Code扩展商店，搜索Azure Functions并更新至最新版本；
  2. 若波浪线仍存在，修改tasks.json，添加环境变量指定ARM版func路径：

     {
       "version": "2.0.0",
       "tasks": [
         {
           "type": "func",
           "command": "host start",
           "problemMatcher": "$func-python-watch",
           "isBackground": true,
           "dependsOn": "pip install (functions)",
           "options": {
             "env": {
               "PATH": "/opt/homebrew/bin:${env:PATH}"
             }
           }
         }
       ]
     }
     

• 确保Python3.9为ARM64原生版本
  检查当前Python架构：

  python3.9 -c "import platform; print(platform.machine())"
  

  若输出为x86_64，需安装ARM原生版Python3.9（推荐用pyenv）：

  pyenv install 3.9.18 --patch <(curl -s https://raw.githubusercontent.com/pyenv/pyenv/master/plugins/python-build/share/python-build/patches/3.9.18/0001-arm64.patch)
  pyenv local 3.9.18
  

• 重新初始化函数项目并安装依赖
  运行以下命令重置项目结构（适配V2模型，兼容性更好）：

  func init --worker-runtime python --model V2
  pip install -r requirements.txt
  

• 验证本地运行
  在VS Code中按F5启动调试，或终端运行func host start，确认函数能正常启动并响应请求。

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