Python 项目实战系列 — （6）企业级 Python 项目模板（Serverless / Web）

目录

一、整体设计目标（企业级）

二、模板一：企业级 Serverless Python 项目（AWS）

1️⃣ 技术选型（标准化）

2️⃣ 目录结构

3️⃣ template.yaml（最小可运行）

4️⃣ Lambda 入口（app.py）

5️⃣ 路由分发（router.py）

6️⃣ 依赖文件（requirements）

7️⃣ 本地运行（开发必做）

8️⃣ 部署（一条命令）

三、模板二：企业级 Web Python 项目（FastAPI）

1️⃣ 技术选型

2️⃣ 目录结构（企业标准）

3️⃣ FastAPI 入口（main.py）

4️⃣ API 示例（api/user.py）

5️⃣ requirements.txt

6️⃣ 本地启动

7️⃣ 文档自动生成

四、统一企业级最佳实践（重点）

依赖管理

环境变量

日志规范

CI/CD 必做清单

五、什么时候选 Serverless / Web？

企业级 Python 项目模板（Serverless / Web），覆盖 Serverless（AWS Lambda） 与 传统 Web（FastAPI） 两种主流形态。

一、整体设计目标（企业级）

• 统一依赖管理
• 支持多环境（dev / test / prod）
• 可 CI/CD
• 可观测（日志 / 追踪）
• 可扩展（中大型项目）
• 云原生 / Serverless Ready

二、模板一：企业级 Serverless Python 项目（AWS）

1️⃣ 技术选型（标准化）

2️⃣ 目录结构

serverless-python-project/ ├── template.yaml # SAM 模板 ├── requirements.txt # 生产依赖 ├── requirements-dev.txt # 开发依赖 ├── src/ │ ├── app.py # Lambda 入口 │ ├── config.py # 配置加载 │ ├── router.py # 路由分发 │ ├── services/ │ │ └── user_service.py │ ├── models/ │ │ └── user.py │ └── utils/ │ └── logger.py ├── tests/ │ └── test_app.py ├── scripts/ │ ├── deploy.sh │ └── local_run.sh ├── .env.example ├── .gitignore └── README.md

3️⃣ template.yaml（最小可运行）

AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Globals: Function: Runtime: python3.11 Timeout: 10 MemorySize: 512 Resources: BackendFunction: Type: AWS::Serverless::Function Properties: CodeUri: src/ Handler: app.lambda_handler Events: Api: Type: Api Properties: Path: /{proxy+} Method: ANY

4️⃣ Lambda 入口（app.py）

from router import route from utils.logger import get_logger logger = get_logger() def lambda_handler(event, context): logger.info("event received") return