在 Azure Functions 中，可通过将 .py 文件与 function_app.py 放置在同一目录下并使用普通 import 语句直接导入；若置于子目录中，则需确保该目录含 __init__.py 并采用相对或绝对包路径导入。
在 azure functions 中，可通过将 `.py` 文件与 `function_app.py` 放置在同一目录下并使用普通 `import` 语句直接导入；若置于子目录中，则需确保该目录含 `__init__.py` 并采用相对或绝对包路径导入。
Azure Functions 对 Python 项目的模块导入有明确的运行时约定：函数入口文件（如 function_app.py）所在的目录即为 Python 的顶层包根目录（sys.path[0]）。这意味着，只要自定义模块（如 newconfig.py）与 function_app.py 处于同一级目录下，即可通过标准 import newconfig 语法直接导入——无需额外配置、无需修改 PYTHONPATH，也无需打包进 site-packages。
✅ 正确做法（推荐）：
- 将
newconfig.py与function_app.py置于项目根目录（即src/目录下，对应 GitHub Actions 中package: src的部署路径）； - 在
function_app.py中直接写：import newconfig
- 使用时可实例化类：
config = newconfig.MyConfig(ftp_host="example.com", azure=True)
⚠️ 常见错误与修复：
- ❌ 错误：
ModuleNotFoundError: No module named 'newconfig'
→ 原因：newconfig.py不在function_app.py同级目录，或文件名含非法字符（如-）、缺少.py后缀、存在语法错误导致导入失败。 - ❌ 错误：
ImportError: attempted relative import with no known parent package
→ 原因：误用from . import newconfig或from .newconfig import MyConfig，但当前模块未被识别为包的一部分（缺少__init__.py或调用方式不匹配）。
? 若需组织为子包（如 config/newconfig.py）：
- 在
config/目录下添加空文件__init__.py（必须！）； - 确保目录结构为：
src/ ├── function_app.py ├── requirements.txt └── config/ ├── __init__.py ← 关键：声明为 Python 包 └── newconfig.py - 导入方式改为：
from config import newconfig # 或 from config.newconfig import MyConfig
? 部署验证建议：
- 本地调试时，使用
func start运行前，确认newconfig.py已保存且无语法错误（如class定义末尾缺失:）； - GitHub Actions 部署后，可在 Azure Portal → 函数应用 → Log Stream 或 App Service Logs 中查看启动日志，定位 ImportError 具体行号；
- 若使用 VS Code 开发，建议安装 Azure Functions 扩展，并启用
Azure Functions: Deploy to Function App时选择src作为工作目录，确保文件结构一致。
? 补充最佳实践：
- 避免在
newconfig.py中执行副作用代码（如网络请求、文件读取），仅定义类/常量/工具函数； - 敏感配置（如
ftp_password、sharepoint_clientsecret）切勿硬编码，应改用 Azure Functions 的 Application Settings +os.environ.get()方式注入； - 可配合
typing.TYPE_CHECKING和if TYPE_CHECKING:块做类型提示隔离，提升 IDE 支持度而不影响运行时。
遵循上述结构与规范，即可安全、可靠地在 Azure Functions 中复用任意自定义 Python 模块。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
