philologue/python

Python开发环境镜像

镜像概述

本镜像提供了一个预配置的Python开发环境，已内置poetry（依赖管理工具）、black（代码格式化工具）、flake8（静态代码检查工具）和isort（导入语句排序工具）。无需额外安装即可直接使用这些工具，简化Python项目的依赖管理、代码格式化及静态分析流程，提升开发效率。

核心功能与特性

• poetry：Python依赖管理与打包工具，支持虚拟环境创建、依赖版本控制及项目打包发布
• black：自动化代码格式化工具，遵循PEP 8规范，确保代码风格一致性
• flake8：静态代码检查工具，集成pyflakes（语法错误检查）、pycodestyle（PEP 8规范检查）和mccabe（代码复杂度分析）
• isort：导入语句排序工具，自动按规范排序import语句，提升代码可读性

使用场景与适用范围

• Python项目本地开发环境搭建
• 代码格式化自动化处理
• 静态代码质量检查与分析
• CI/CD流程中的代码规范验证环节
• 团队协作中的代码风格统一

使用方法与配置说明

基础使用（docker run）

bash
# 运行容器并挂载当前项目目录
docker run -it --rm -v $(pwd):/app -w /app [镜像名称] /bin/bash

# 在容器内使用poetry管理依赖
poetry install          # 安装项目依赖
poetry add requests     # 添加依赖包
poetry run python main.py  # 运行项目

# 使用black格式化代码
black your_script.py    # 格式化单个文件
black src/              # 格式化目录下所有文件

# 使用flake8检查代码
flake8 your_script.py   # 检查单个文件
flake8 src/             # 检查目录下所有文件

# 使用isort排序导入语句
isort your_script.py    # 排序单个文件的导入语句
isort src/              # 排序目录下所有文件的导入语句

docker-compose配置示例

yaml
version: '3'
services:
  python-dev:
    image: [镜像名称]
    volumes:
      - ./:/app
    working_dir: /app
    tty: true  # 保持容器运行

关键配置说明

• 数据持久化：通过-v $(pwd):/app挂载本地项目目录，确保代码修改实时同步到容器内
• 工作目录：使用-w /app设置容器内工作目录为项目根目录，便于直接执行命令
• 工具配置文件：支持通过项目根目录下的配置文件（如pyproject.toml、.flake8、.isort.cfg）自定义工具行为，配置文件会通过挂载自动应用

注意事项

• 请将上述命令中的[镜像名称]替换为实际使用的Docker镜像名称
• 首次使用poetry时，可能需要根据项目pyproject.toml文件安装依赖
• 工具版本信息可通过poetry --version、black --version等命令查看