图片中文字无法正确显示的解决方案

图片中文字无法正确显示的解决方案

问题描述

在 Linux 系统中生成图片时，图片中的文字（如中文）未能正确显示，可能表现为乱码或空白。这通常是由于系统缺少对应的字体文件（如宋体/SimSun），或者 Java 应用未正确加载字体导致的。

---

解决方案步骤

1. 安装宋体字体

确保 Linux 系统中已安装宋体字体（SimSun）。如果未安装，请按照以下步骤操作：

1.1 检查是否已安装宋体

运行以下命令，检查系统中是否已安装宋体字体：

fc-list | grep "SimSun"

• 如果返回结果，则说明宋体已安装。
• 如果没有返回结果，则需要手动安装宋体。

1.2 下载宋体字体文件

从可信来源获取宋体字体文件（如 simsun.ttc 或 simsun.ttf）。以下是一些常见方法：

• 从 Windows 系统复制：从 Windows 的 C:\Windows\Fonts 目录中复制 simsun.ttc 文件。
• 在线下载：从公开资源下载宋体字体文件，例如：

  wget https://github.com/npqzxc/FontSimsun/raw/master/simsun.ttf
  

1.3 创建字体目录并安装字体

将字体文件复制到系统的字体目录中。推荐使用 /usr/share/fonts/chinese/ 目录：

sudo mkdir -p /usr/share/fonts/chinese
sudo cp simsun.ttc /usr/share/fonts/chinese/

1.4 更新字体缓存

安装完成后，更新字体缓存以使系统识别新字体：

sudo fc-cache -fv

1.5 验证字体安装

再次运行以下命令，确认宋体是否安装成功：

fc-list | grep "SimSun"

如果返回类似以下输出，则说明安装成功：

/usr/share/fonts/chinese/simsun.ttc: SimSun,宋体:style=Regular

---

2. 刷新字体缓存

在安装字体后，确保字体缓存已正确刷新：

sudo fc-cache -fv

此步骤会重新生成字体缓存文件，使系统能够识别新安装的字体。

---

3. 重启相关 Java 服务

在完成字体安装和验证后，需要重启相关的 Java 服务以确保应用能够正确加载新字体。

3.1 停止 Java 服务

根据你的 Java 服务类型，执行以下命令停止服务：

• Spring Boot 应用：

  ./your-spring-boot-app.sh stop
  

• Tomcat：

  sudo systemctl restart tomcat
  

3.2 启动 Java 服务

启动服务以加载新字体：

• Spring Boot 应用：

  ./your-spring-boot-app.sh start
  

• Tomcat：

  sudo systemctl start tomcat
  

---

5. 测试图片生成

重启服务后，重新生成图片，正确显示如下。

---

总结

通过以上步骤，你可以解决图片中文字无法正确显示的问题。具体流程如下：

1. 安装宋体字体：将 simsun.ttc 文件复制到 /usr/share/fonts/chinese/ 目录，并更新字体缓存。
2. 刷新字体缓存：运行 fc-cache -fv 确保字体被系统识别。
3. 验证字体：通过命令行或 Java 代码验证字体是否可用。
4. 重启 Java 服务：确保 Java 应用能够正确加载新字体。
5. 测试图片生成：重新生成图片并检查文字是否正确显示。