Linux Docker环境中解决中文字体乱码问题完整指南

问题背景

在Linux Docker环境中运行涉及中文显示的应用时（如Selenium网页截图、PDF生成等），经常会遇到中文显示为方块或乱码的问题。这是因为Linux系统默认没有安装中文字体所导致的。

解决方案

我们可以从Windows系统复制常用中文字体到Docker容器中来解决这个问题。以下是详细步骤：

1. 从Windows系统导出字体

# Windows字体目录位置
C:\Windows\Fonts

# 1. 创建临时目录
mkdir D:\temp_fonts

# 2. 复制需要的中文字体到临时目录
# 建议复制以下常用中文字体：(省事就全部复制)
- SimSun.ttf (宋体)
- SimHei.ttf (黑体)
- Microsoft YaHei.ttf (微软雅黑)
- KaiTi.ttf (楷体)
- FangSong.ttf (仿宋)

2. 压缩字体文件

# 使用7-Zip将字体文件压缩为zip格式
# 右键选择临时字体目录 -> 7-Zip -> 添加到压缩文件
# 选择zip格式，创建 chinese_fonts.zip

3. 传输到Linux服务器

# 使用scp命令传输文件到Linux服务器
scp D:\temp_fonts\chinese_fonts.zip root@your_server_ip:/root/

# 或使用其他文件传输工具如FileZilla等

4. 在Linux服务器上处理文件

# 1. 登录服务器
ssh root@your_server_ip

# 2. 创建字体目录
mkdir -p /usr/share/fonts/chinese

# 3. 解压字体文件
cd /root/
unzip chinese_fonts.zip -d /usr/share/fonts/chinese/

# 4. 设置权限
chmod -R 755 /usr/share/fonts/chinese

5. 复制到Docker容器

# 1. 查看运行中的容器
docker ps

# 2. 复制字体到容器
docker cp /usr/share/fonts/chinese your_container_id:/usr/share/fonts/

# 3. 进入容器
docker exec -it your_container_id bash

# 4. 设置字体权限
chmod -R 755 /usr/share/fonts/chinese

# 5. 更新字体缓存
fc-cache -fv

# 6. 验证字体安装
fc-list :lang=zh

验证安装

# Python代码示例：测试中文字体
from PIL import Image, ImageDraw, ImageFont

def test_font():
    # 创建图片
    img = Image.new('RGB', (400, 100), color='white')
    d = ImageDraw.Draw(img)
    
    # 使用中文字体
    font = ImageFont.truetype('/usr/share/fonts/chinese/SimSun.ttf', 24)
    
    # 绘制中文文本
    d.text((10,10), "测试中文字体显示", font=font, fill='black')
    
    # 保存图片
    img.save('test.png')

test_font()

常见问题解决

1. 字体文件权限问题

   如果遇到权限问题，执行：

   chmod 644 /usr/share/fonts/chinese/*
   chmod 755 /usr/share/fonts/chinese

2. 字体缓存更新失败

# 清理字体缓存后重新生成
rm -rf /var/cache/fontconfig/*
fc-cache -fv

3. 容器重启后字体消失

# 将字体目录挂载到容器
docker run -v /usr/share/fonts/chinese:/usr/share/fonts/chinese ...

相关命令参考

# 查看所有中文字体
fc-list :lang=zh

# 查看字体详细信息
fc-match -v "字体名称"

# 检查字体配置
fc-conflist

# 清理字体缓存
fc-cache -fv