使用VS Code搭建Azure Function本地测试环境时遇到问题

• 确认VS Code使用的Python解释器
  按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Python: Select Interpreter，选择你安装了目标包的Python环境（比如项目虚拟环境、Anaconda环境）。可以在终端执行which python（Mac/Linux）或where python（Windows），对比终端使用的解释器和VS Code选中的是否一致。

• 匹配pip安装环境与VS Code解释器

  • 如果使用虚拟环境，先激活环境再安装包：
    Windows：.\venv\Scripts\activate
    Mac/Linux：source venv/bin/activate
    激活后执行pip install [包名]
  • 直接指定解释器执行pip，避免环境混淆：python3 -m pip install [包名]（Windows用python -m pip install [包名]）

• 正确配置Python路径

  • 若模块在项目子目录中，确保该目录下存在__init__.py文件（空文件即可），让Python识别为可导入的包。
  • 在VS Code的.vscode/launch.json中添加PYTHONPATH配置，将项目根目录加入路径：

    {
        "version": "0.2.0",
        "configurations": [
            {
                "name": "Python: Current File",
                "type": "python",
                "request": "launch",
                "program": "${file}",
                "env": {"PYTHONPATH": "${workspaceFolder}"},
                "console": "integratedTerminal"
            }
        ]
    }
    

• 解决包无法安装的问题

  • 若因网络问题安装失败，切换国内PyPI源：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple [包名]
  • 若因编译依赖失败：
    Windows：安装Microsoft Visual C++ Build Tools
    Mac：执行xcode-select --install安装Xcode命令行工具
    Linux：安装gcc、python3-dev等依赖包（如sudo apt install gcc python3-dev）

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