python项目生产部署需五步：一、规范代码结构；二、pip-tools锁定依赖；三、配置分离+环境变量注入；四、ci中执行格式/静态/测试门禁；五、多阶段docker构建，镜像≤120mb，entrypoint运行。
如果您正在将 Python 项目从本地开发环境推进至生产部署阶段，可能面临代码一致性、依赖管理、环境隔离、服务启动与监控等多环节衔接问题。以下是完成该流程的关键实践步骤：
一、代码结构规范化与模块化
统一的项目结构有助于团队协作、测试覆盖与 CI/CD 流水线集成，同时为后续打包和部署提供清晰边界。
1、创建标准目录结构：根目录下包含 src/（主程序模块）、tests/（单元与集成测试）、requirements/（分环境依赖文件）、config/（配置模板）和 pyproject.toml（构建与格式化配置）。
2、将业务逻辑封装为独立模块，避免在 __main__.py 中编写执行逻辑，确保可通过 python -m mypackage 方式运行。
立即学习“Python免费学习笔记（深入）”；
3、在 src/ 下添加 __init__.py 并定义 __all__ 列表，显式声明公共接口。
二、依赖管理与环境隔离
使用可复现的依赖声明方式，防止因版本漂移导致开发与生产行为不一致。
1、采用 pip-tools 管理依赖：通过 requirements.in 声明顶层依赖，运行 pip-compile requirements.in 生成锁定版本的 requirements.txt。
2、在 CI 和生产镜像中均使用 –no-deps –no-install-recommends 参数配合 pip install -r requirements.txt，跳过隐式依赖解析。
3、禁止在生产环境中使用 pip install . 直接安装源码包，必须先构建为 wheel 包并验证签名与哈希值。
三、配置分离与运行时注入
避免硬编码配置，实现不同环境间零代码变更切换。
1、将配置按层级拆分为 base.py（通用项）、development.py、production.py，并通过 CONFIG_MODULE 环境变量指定加载路径。
2、敏感字段（如数据库密码、API密钥）仅通过环境变量传入，应用启动时校验 os.environ.get(‘DB_PASSWORD’) 是否非空，为空则立即退出。
3、使用 python-decouple 或 dynaconf 实现类型安全解析，例如自动将字符串 ‘true’ 转为布尔值 True。
四、自动化测试与质量门禁
保障代码进入生产前具备基本可靠性，防止低级错误流入部署流水线。
1、在 tests/ 中按功能划分子目录，每个测试文件以 test_ 开头，函数名以 test_ 开头，并标注 @pytest.mark.unit 或 @pytest.mark.integration 标签。
2、CI 阶段依次执行：black –check .（格式检查）、flake8 src/ tests/（静态分析）、pytest –cov=src –cov-report=term-missing（覆盖率报告）。
3、设定门禁阈值：单元测试覆盖率低于 80% 或存在 E999 类语法错误时，CI 构建失败并阻断发布。
五、容器化构建与轻量部署
通过标准化镜像消除“在我机器上能跑”的环境差异，提升部署效率与可审计性。
1、基于 python:3.11-slim-bookworm 构建基础镜像，删除 apt-get 缓存与文档包，镜像大小控制在 120MB 以内。
2、使用多阶段构建：第一阶段安装构建依赖并运行 pip wheel –no-deps –wheel-dir /wheels -r requirements.txt；第二阶段仅复制 /wheels/ 中的 wheel 文件并安装。
3、入口点设为 ENTRYPOINT [“python”, “-m”, “mypackage”]，禁止使用 CMD 覆盖，确保进程为 PID 1 并能接收系统信号。