调试Python Azure函数遇错误：attempted relative import with no known parent package

问题原因 #

Azure生产环境会自动将/folder1目录识别为Python包的根目录，subfolder1作为子模块加载，因此相对导入能正常工作。但本地调试时，VS Code的Python调试上下文默认未将folder1纳入包结构，导致subfolder1被当作顶层模块，触发相对导入错误。

无需修改代码的解决方法 #

方法1：调整VS Code调试配置（launch.json） #

在VS Code的.vscode/launch.json中，为Azure函数调试配置添加环境变量或修改工作目录：

1. 打开.vscode/launch.json（无则创建）
2. 在对应调试配置中添加以下内容：

{
    "name": "Python: Azure Functions",
    "type": "python",
    "request": "launch",
    "program": "${workspaceFolder}/folder1/.venv/bin/func", // 替换为你的虚拟环境func路径，或直接用系统全局func
    "args": ["start"],
    "env": {
        "PYTHONPATH": "${workspaceFolder}/folder1"
    },
    "cwd": "${workspaceFolder}/folder1"
}

该配置会将folder1设为工作目录，并将其加入Python模块搜索路径，让Python识别它为父包，从而支持相对导入。

方法2：使用Azure Functions Core Tools本地运行 #

直接用官方工具启动函数，自动匹配生产环境的包结构：

1. 打开终端，激活你的虚拟环境
2. 切换到folder1目录：cd /path/to/folder1
3. 运行命令：func start
   这种方式完全模拟Azure生产环境的加载逻辑，相对导入行为会和线上一致，无需额外配置。

验证方式 #

启动调试或运行func start后，触发函数执行，检查from . import file1 as foo和from .file2 import *是否正常加载，不再抛出错误。

内容的提问来源于stack exchange，提问作者David.Warwick