Python 图片验证码生成代码与参数配置指南

远山来客

发布时间：2026-10-12 | 2人浏览过

原创

本文详解如何利用 Python 与 Pillow 图像处理模块构建轻量级图片验证码生成器。通过封装统一接口，开发者可一键控制字符集、干扰线条、噪点分布及画面扭曲程度，快速获取字节流或直接保存为测试图像，适用于 Web 登录校验、API 安全拦截及自动化测试环境。

验证码生成目标与依赖准备

本方案旨在提供一个开箱即用的验证码绘制函数，核心目标是输出同时包含随机字母数字组合与视觉干扰元素的静态图像。在实际接入前，需确保运行环境满足以下基础条件：

安装 Python 解释器（推荐 3.6 及以上版本）
通过包管理器安装绘图依赖：pip install Pillow
准备可用的 TTF 字体文件（如 DejaVuSans.ttf 或系统默认无衬线字体）

准备就绪后，可将完整源码导入项目根目录进行独立调用。

核心代码实现与结构说明

以下为经过格式标准化与 Python 3 兼容性优化的完整实现。代码采用纯函数式结构，所有绘图参数均开放为可调字段：

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

import random
from PIL import Image, ImageDraw, ImageFont, ImageFilter
import io

_letter_cases = "abcdefghjkmnpqrstuvwxy"
_upper_cases = "ABCDEFGHJKLMNPQRSTUVWXY"
_numbers = "1234567890"
init_chars = ''.join((_letter_cases, _upper_cases, _numbers))
default_font = "./DejaVuSans.ttf"


def generate_verify_image(size=(120, 30),
             chars=init_chars,
             img_type="PNG",
             mode="RGB",
             bg_color=(255, 255, 255),
             fg_color=(0, 0, 255),
             font_size=18,
             font_type=default_font,
             length=4,
             draw_lines=True,
             n_line=(1, 2),
             draw_points=True,
             point_chance=2,
             save_img=False):

  width, height = size
  img = Image.new(mode, size, bg_color)
  draw = ImageDraw.Draw(img)

  def get_chars():
    return random.sample(chars, length)

  def create_lines():
    line_num = random.randint(*n_line)
    for i in range(line_num):
      begin = (random.randint(0, size[0]), random.randint(0, size[1]))
      end = (random.randint(0, size[0]), random.randint(0, size[1]))
      draw.line([begin, end], fill=(0, 0, 0))

  def create_points():
    chance = min(100, max(0, int(point_chance)))
    for w in range(width):
      for h in range(height):
        tmp = random.randint(0, 100)
        if tmp > 100 - chance:
          draw.point((w, h), fill=(0, 0, 0))

  def create_strs():
    c_chars = get_chars()
    strs = ' %s ' % ' '.join(c_chars)
    font = ImageFont.truetype(font_type, font_size)
    font_width, font_height = font.getsize(strs)
    
    draw.text(((width - font_width) / 2, (height - font_height) / 2),
              strs, font=font, fill=fg_color)
    return ''.join(c_chars)

  if draw_lines:
    create_lines()
  if draw_points:
    create_points()
  
  actual_strs = create_strs()

  params = [
    1 - float(random.randint(1, 2)) / 100,
    0, 0, 0,
    1 - float(random.randint(1, 10)) / 100,
    float(random.randint(1, 2)) / 500,
    0.001,
    float(random.randint(1, 2)) / 500
  ]
  img = img.transform(size, Image.PERSPECTIVE, params)
  img = img.filter(ImageFilter.EDGE_ENHANCE_MORE)

  mstream = io.BytesIO()
  img.save(mstream, img_type)

  if save_img:
    img.save("validate.png", img_type)

  return mstream, actual_strs


if __name__ == "__main__":
  mstream, strs = generate_verify_image(save_img=True)
  print(f"生成的验证码文本为: {strs}")