Python图像处理：在照片上精准添加中文文字指南

作者：JC2025.10.10 19:28浏览量：6

简介：本文详细介绍如何使用Python在照片上添加中文文字，涵盖字体选择、坐标定位、文字样式调整等关键步骤，提供完整代码示例与实用技巧。

Python图像处理：在照片上精准添加中文文字指南

一、技术背景与需求分析

在图像处理领域，为照片添加文字是常见需求，尤其在证件照标注、商品图片水印、社交媒体分享等场景中。然而，使用Python处理中文文字时，开发者常面临两大挑战：一是中文字体显示异常（如方框或乱码），二是文字位置与样式难以精准控制。本文将系统解决这些问题，提供从环境配置到高级样式的完整解决方案。

1.1 核心问题解析

字体兼容性：系统默认字体通常不支持中文，需指定中文字体文件
坐标系统：图像坐标系原点在左上角，x向右增长，y向下增长
抗锯齿处理：文字边缘锯齿影响视觉效果，需启用抗锯齿
多行文本：需计算行高与换行逻辑

二、环境准备与依赖安装

2.1 基础库安装

推荐使用Pillow（PIL）库进行图像处理，其优势在于：

轻量级（仅需安装单个包）
支持多种图像格式
完善的文字绘制API

安装命令：

pip install pillow

2.2 中文字体准备

需准备以下字体文件之一（建议.ttf格式）：

Windows系统：C:/Windows/Fonts/simhei.ttf（黑体）
macOS系统：/System/Library/Fonts/PingFang.ttc（苹方）
自定义字体：将字体文件放入项目目录

三、基础文字添加实现

3.1 单行文字绘制

from PIL import Image, ImageDraw, ImageFont
def add_chinese_text(img_path, text, pos, font_path, font_size=36, color=(255,255,255)):
    """
    在图片上添加中文文字
    :param img_path: 图片路径
    :param text: 要添加的文字
    :param pos: 文字位置(x,y)
    :param font_path: 字体文件路径
    :param font_size: 字体大小
    :param color: 文字颜色(RGB)
    :return: 处理后的图像对象
    """
    # 打开图片
    img = Image.open(img_path)
    draw = ImageDraw.Draw(img)
    # 加载字体（关键步骤）
    try:
        font = ImageFont.truetype(font_path, font_size)
    except IOError:
        print(f"错误：无法加载字体文件 {font_path}")
        return img
    # 绘制文字（启用抗锯齿）
    draw.text(pos, text, font=font, fill=color, stroke_width=1, stroke_fill=(0,0,0))
    return img
# 使用示例
image = add_chinese_text(
    "input.jpg",
    "Python处理中文",
    (50, 50),
    "simhei.ttf",
    48,
    (255, 0, 0)
)
image.save("output.jpg")

3.2 多行文本处理

def add_multiline_text(img_path, text_lines, pos, font_path, line_height=50, **kwargs):
    """
    添加多行中文文本
    :param text_lines: 文本行列表
    :param line_height: 行高
    :param pos: 起始位置(x,y)
    """
    img = Image.open(img_path)
    draw = ImageDraw.Draw(img)
    font = ImageFont.truetype(font_path, kwargs.get('font_size', 36))
    current_y = pos[1]
    for line in text_lines:
        text_width, text_height = draw.textsize(line, font=font)
        draw.text((pos[0], current_y), line, font=font, fill=kwargs.get('color', (255,255,255)))
        current_y += line_height
    return img

四、高级功能实现

4.1 文字描边效果

def add_text_with_outline(img_path, text, pos, font_path, font_size, color, outline_color, outline_width=2):
    img = Image.open(img_path).convert("RGBA")
    txt = Image.new("RGBA", img.size, (255,255,255,0))
    draw = ImageDraw.Draw(txt)
    font = ImageFont.truetype(font_path, font_size)
    # 绘制描边（通过多次偏移绘制实现）
    for x in range(-outline_width, outline_width+1):
        for y in range(-outline_width, outline_width+1):
            if (x,y) != (0,0):  # 中心点不绘制
                draw.text((pos[0]+x, pos[1]+y), text, font=font, fill=outline_color)
    # 绘制主体文字
    draw.text(pos, text, font=font, fill=color)
    # 合并图层
    result = Image.alpha_composite(img, txt)
    return result.convert("RGB")

4.2 文字自动换行

def add_wrapped_text(img_path, text, pos, font_path, max_width, font_size=36, color=(255,255,255)):
    img = Image.open(img_path)
    draw = ImageDraw.Draw(img)
    font = ImageFont.truetype(font_path, font_size)
    lines = []
    current_line = ""
    for word in text:
        test_line = current_line + word
        test_width, _ = draw.textsize(test_line, font=font)
        if test_width < max_width:
            current_line = test_line
        else:
            lines.append(current_line)
            current_line = word
    if current_line:
        lines.append(current_line)
    return add_multiline_text(img_path, lines, pos, font_path, font_size=font_size, color=color)

五、常见问题解决方案

5.1 字体显示异常处理

问题现象：文字显示为方框或乱码
解决方案：

确认字体文件路径正确
检查字体文件是否损坏（尝试用其他软件打开）
使用绝对路径替代相对路径
验证字体是否包含所需字符集

5.2 文字位置计算技巧

居中显示：

def add_centered_text(img_path, text, y_pos, font_path, font_size, color):
  img = Image.open(img_path)
  draw = ImageDraw.Draw(img)
  font = ImageFont.truetype(font_path, font_size)
  text_width, _ = draw.textsize(text, font=font)
  x_pos = (img.width - text_width) // 2
  draw.text((x_pos, y_pos), text, font=font, fill=color)
  return img

右下角水印：

def add_watermark(img_path, text, font_path, padding=20, font_size=24, color=(255,255,255,128)):
  img = Image.open(img_path).convert("RGBA")
  txt = Image.new("RGBA", img.size, (255,255,255,0))
  draw = ImageDraw.Draw(txt)
  font = ImageFont.truetype(font_path, font_size)
  text_width, text_height = draw.textsize(text, font=font)
  x_pos = img.width - text_width - padding
  y_pos = img.height - text_height - padding
  draw.text((x_pos, y_pos), text, font=font, fill=color)
  return Image.alpha_composite(img, txt).convert("RGB")

六、性能优化建议

字体缓存：对重复使用的字体对象进行缓存
```python
from functools import lru_cache

@lru_cache(maxsize=32)
def get_font(font_path, size):
return ImageFont.truetype(font_path, size)


2. **批量处理**：对多张图片使用相同的字体时，避免重复加载
3. **图像格式选择**：
   - 输出为PNG保留透明度
   - 输出为JPEG时，质量参数建议85-95
4. **多线程处理**：对大量图片处理时，可使用`concurrent.futures`
## 七、完整项目示例
```python
import os
from PIL import Image, ImageDraw, ImageFont
class ImageTextProcessor:
    def __init__(self, default_font="simhei.ttf"):
        self.default_font = default_font
        self.font_cache = {}
    def get_font(self, size):
        key = (self.default_font, size)
        if key not in self.font_cache:
            try:
                self.font_cache[key] = ImageFont.truetype(self.default_font, size)
            except IOError:
                raise FileNotFoundError(f"无法加载字体文件: {self.default_font}")
        return self.font_cache[key]
    def add_text(self, img_path, output_path, text, pos, font_size=36, color=(255,255,255)):
        img = Image.open(img_path)
        draw = ImageDraw.Draw(img)
        font = self.get_font(font_size)
        draw.text(pos, text, font=font, fill=color)
        img.save(output_path)
        return output_path
    def add_centered_text(self, img_path, output_path, text, y_pos, font_size=36, color=(255,255,255)):
        img = Image.open(img_path)
        draw = ImageDraw.Draw(img)
        font = self.get_font(font_size)
        text_width, _ = draw.textsize(text, font=font)
        x_pos = (img.width - text_width) // 2
        draw.text((x_pos, y_pos), text, font=font, fill=color)
        img.save(output_path)
        return output_path
# 使用示例
processor = ImageTextProcessor("msyh.ttc")  # 微软雅黑字体
processor.add_centered_text(
    "input.jpg",
    "output_centered.jpg",
    "居中文本示例",
    y_pos=100,
    font_size=48,
    color=(0, 128, 255)
)

八、总结与扩展

本文系统介绍了使用Python在照片上添加中文文字的完整方案，涵盖：

环境配置与依赖安装
基础文字绘制方法
多行文本与自动换行处理
高级效果实现（描边、透明度）
常见问题解决方案
性能优化技巧

扩展方向：

结合OpenCV实现更复杂的图像处理
使用Flask/Django构建Web服务
开发GUI工具（如PyQt）
实现OCR 文字识别与替换的完整流程

通过掌握这些技术，开发者可以轻松实现照片文字标注、水印添加、自动化图片生成等实用功能，大幅提升图像处理效率。

发表评论

开发者关注产品榜

最热文章

关于作者

被阅读数
被赞数
被收藏数

活动

咨询

开发者热搜

Python图像处理：在照片上精准添加中文文字指南

Python图像处理：在照片上精准添加中文文字指南

一、技术背景与需求分析

1.1 核心问题解析

二、环境准备与依赖安装

2.1 基础库安装

2.2 中文字体准备

三、基础文字添加实现

3.1 单行文字绘制

3.2 多行文本处理

四、高级功能实现

4.1 文字描边效果

4.2 文字自动换行

五、常见问题解决方案

5.1 字体显示异常处理

5.2 文字位置计算技巧

六、性能优化建议

八、总结与扩展

相关文章推荐

文心一言接入指南：通过百度智能云千帆大模型平台API调用

从 MLOps 到 LMOps 的关键技术嬗变

Sugar BI教你怎么做数据可视化 - 拓扑图，让节点连接信息一目了然

更轻量的百度百舸，CCE Stack 智算版发布

打造合规数据闭环，加速自动驾驶技术研发

LMOps 工具链与千帆大模型平台

发表评论

开发者关注产品榜

百度千帆·大模型服务及Agent开发平台

百度千帆·数据智能平台

秒哒-生成式应用开发平台

百度智能云客悦智能客服平台

最热文章

关于作者