基于同一 Python 包构建 AWS Lambda 函数的实践指南

新闻中心 NEWS CENTER

2025-11-03

浏览次数：次

本文旨在解决在 aws lambda 函数中使用共享 python 包时，本地开发环境与生产环境代码差异的问题。通过配置 ide 的额外路径，使本地开发环境能够正确识别共享包，从而实现本地代码与生产代码的一致性，提高开发效率并减少部署错误。

在构建 AWS Serverless 应用时，经常会遇到多个 Lambda 函数需要共享同一个 Python 包的情况。例如，一个名为 common_lib 的包，包含一些常用的工具函数，被 lambda1 和 lambda2 两个 Lambda 函数所引用。

一种常见的项目结构如下：

common_lib/
├── __init__.py
└── utils.py
lambda1/
└── lambda_function.py
lambda2/
└── lambda_function.py

在生产环境中，通常会将 common_lib 打包成一个 Lambda Layer，然后在 Lambda 函数中直接引用：

import common_lib.utils
# ...

然而，在本地开发环境中，由于项目结构的差异，可能需要使用相对路径引用：

import ..common_lib.utils
# ...

这种差异会导致本地代码和生产代码不一致，增加维护成本和潜在的部署风险。本文将介绍一种解决此问题的方法，使本地代码和生产代码保持一致。

解决方案：配置 IDE 的额外路径

Musho

AI网页设计Figma插件

76 查看详情 Musho

一种简单有效的解决方案是配置 IDE 的额外路径，让 IDE 能够识别 common_lib 包。以 Visual Studio Code (VSCode) 为例，可以在 .vscode/settings.json 文件中添加以下配置：

{
    "python.analysis.extraPaths": [
        "./common_lib"
    ]
}

这个配置告诉 VSCode 的 Python 语言服务器，除了默认的搜索路径之外，还要搜索当前目录下的 common_lib 目录。这样，在本地开发环境中，就可以像生产环境一样，直接使用 import common_lib.utils 引用 common_lib 包了。

注意事项

仅适用于 IDE： 这种方法仅适用于 IDE 的代码补全和静态分析。如果直接从命令行运行 Python 代码，解释器仍然无法识别 common_lib 包，因为解释器没有意识到额外的路径。
其他 IDE： 不同的 IDE 有不同的配置方式。例如，PyCharm 可以在 "Project Structure" 设置中添加 Content Root。
其他解决方案： 还有其他解决方案，例如使用 PYTHONPATH 环境变量，或者使用 setuptools 将 common_lib 安装到本地环境中。

总结

通过配置 IDE 的额外路径，可以有效地解决在 AWS Lambda 函数中使用共享 Python 包时，本地开发环境与生产环境代码差异的问题。这种方法简单易行，能够提高开发效率并减少部署错误。在实际开发中，可以根据自己的项目结构和 IDE 选择合适的解决方案。

以上就是基于同一 Python 包构建 AWS Lambda 函数的实践指南的详细内容，更多请关注其它相关文章！