如何让本地与生产环境的AWS Lambda代码导入公共包方式一致？

下面几种方法可以让你在本地和Lambda生产环境中使用相同的import common_lib.utils导入语句：

方法1：动态修改Python搜索路径 #

在每个Lambda函数的代码开头添加一段逻辑，仅在本地开发时将项目根目录加入Python的搜索路径，生产环境不受影响：

import sys
import os
from pathlib import Path

# 仅本地开发时执行路径添加逻辑
if os.getenv("LOCAL_DEV") == "True":
    # 获取项目根目录（即common_lib所在的目录）
    project_root = Path(__file__).parent.parent
    sys.path.append(str(project_root))

# 本地和生产环境统一使用该导入语句
import common_lib.utils

使用时，本地运行前设置环境变量：

• Linux/macOS：export LOCAL_DEV=True
• Windows PowerShell：$env:LOCAL_DEV = "True"

优点：无需调整现有项目结构，改动最小；生产环境无额外代码负担。
缺点：需要手动设置环境变量，多人协作时要同步这个配置。

方法2：模拟Lambda Layer本地目录结构 #

按照Lambda Layer的要求调整本地项目结构，让本地依赖路径和生产环境完全对齐：

调整后的项目结构：

your_project/
├── layers/
│   └── common_lib/
│       └── python/
│           └── common_lib/
│               ├── __init__.py
│               └── utils.py
├── lambda1/
│   └── lambda_function.py
└── lambda2/
    └── lambda_function.py

本地运行时，将Layer目录加入Python路径：

• Linux/macOS：export PYTHONPATH="./layers/common_lib/python:$PYTHONPATH"
• Windows PowerShell：$env:PYTHONPATH = ".\layers\common_lib\python;$env:PYTHONPATH"

之后代码里直接用import common_lib.utils即可，生产环境部署时，将layers/common_lib打包成Layer上传，逻辑完全一致。

优点：完全复刻生产环境的依赖结构，避免本地与生产的差异；适合团队协作时统一环境配置。
缺点：需要调整现有项目结构，迁移common_lib目录。

方法3：将common_lib作为本地可编辑包安装 #

利用pip的可编辑安装模式，把common_lib当作本地第三方包安装到虚拟环境中：

在项目根目录执行命令：

pip install -e ./common_lib

-e参数表示可编辑模式，后续修改common_lib的代码会实时生效，无需重新安装。安装后，本地虚拟环境的site-packages中会生成common_lib的引用，代码里直接使用import common_lib.utils即可，和生产环境的Layer导入逻辑一致。

优点：符合Python常规的依赖管理习惯，无需修改代码或调整结构；支持IDE的代码提示和跳转。
缺点：需要依赖虚拟环境，新成员加入时需要执行安装命令。

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