Linux系统设置中文语言环境和字体- FineReport帮助文档

文档创建者：yiyemeiying

历史版本：20

最近更新：Carly 于 2024-08-07

本文仅面向非运维平台部署的帆软项目

运维平台部署的项目，在工程外挂目录/customlib/fonts文件夹，可用于存放客户自定义的字体文件，等同于直接放置在/usr/share/fonts下

1. 概述

1.1 问题描述

工程部署在Linux 系统中时，有时我们访问工程会遇到中文乱码。

1.2 原因分析

出现这个情况有多种原因：

1）工程所在的服务器，没有设置中文为默认语言。

2）工程所在的服务器，没有安装模板对应的字体包。

本文以 centos 系统为例。其他 Linux 版本安装步骤有所不同，请根据你的系统需求自行调整。

2. 设置默认语言环境

1）检查服务器是否安装中文语言环境，如果没有则需要安装

2）检查中文语言环境是否是默认语言环境，如果不是需要设置

2.1 安装中文语言环境

首先检查当前服务器系统是否已安装中文语言环境，如果没有就需要安装中文语言环境。

1）查看当前系统是否已安装中文语言环境

命令	说明
locale -a \| grep zh_CN	返回值：该命令会列出系统中所有可用的中文语言环境如果返回值中有zh_CN.utf8，说明系统已安装中文语言环境，直接进入2.2节如果返回值中没有zh_CN.utf8，则需要执行第二步，安装中文语言环境

命令

说明

locale -a | grep zh_CN

返回值：该命令会列出系统中所有可用的中文语言环境

如果返回值中有zh_CN.utf8，说明系统已安装中文语言环境，直接进入2.2节
如果返回值中没有zh_CN.utf8，则需要执行第二步，安装中文语言环境

2）安装中文语言环境

如果上一步检查出，系统未安装中文语言环境，请根据你的服务器网络环境，安装中文语言环境。

服务器	操作
外网	命令：yum install kde-l10n-Chinese 说明：这个命令将安装中文本地化包。根据你的系统和包管理器，可能需要确认安装过程中的提示信息
内网	1）下载kde-l10n-Chinese安装包请根据你使用的 Linux 系统发行版和版本，自行查找相关安装包资源，帆软不提供此部分资源将kde-l10n-Chinese安装包上传到服务器中。本示例上传到/home/test文件夹下 2）安装语言环境进入安装包所在目录（请自行调整目录位置）：cd /home/test 安装kde-l10n-Chinese（请自行调整安装包名称）：rpm -ivh kde-l10n-Chinese-4.10.5-2.el7.noarch.rpm --nodeps --force

服务器

操作

外网

命令：yum install kde-l10n-Chinese
说明：这个命令将安装中文本地化包。根据你的系统和包管理器，可能需要确认安装过程中的提示信息

内网

1）下载kde-l10n-Chinese安装包

请根据你使用的 Linux 系统发行版和版本，自行查找相关安装包资源，帆软不提供此部分资源
将kde-l10n-Chinese安装包上传到服务器中。本示例上传到/home/test文件夹下

2）安装语言环境

进入安装包所在目录（请自行调整目录位置）：cd /home/test
安装kde-l10n-Chinese（请自行调整安装包名称）：rpm -ivh kde-l10n-Chinese-4.10.5-2.el7.noarch.rpm --nodeps --force

2.2 设置中文为默认语言环境

服务器系统中安装了中文语言环境后，还需要将其设置为默认语言环境。

1）查看默认语言环境是否是中文

命令	说明
locale	返回值：将显示当前的语言环境变量，其中 LANG 表示默认的字符编码如果 LANG 值包含.utf8，说明默认语言为中文，字符编码为UTF-8，一切正常，直接进入第三章即可如果 LANG 值为其他，则需要继续进行下一步操作

2）设置中文为默认语言环境

临时方法无需重启Linux系统，只需要关闭重新打开终端即可。
永久方案需要重启Linux系统，请按需选择。


临时方案	1）登录终端打开终端，并使用管理员权限登录到系统。 2）设置默认语言环境命令：sudo localectl set-locale LANG=zh_CN.utf8 说明：这个命令将更新系统的语言环境配置文件，将默认语言设置为 zh_CN.utf8 3）重新访问终端为了使语言环境的更改生效，请关闭终端，重新登录访问Linux系统 4）确认设置成功命令：locale 说明：如果 LANG 返回值包含.utf8，说明设置成功
永久方案	1）登录终端打开终端，并使用管理员权限登录到系统。 2）修改配置使用 vi 编辑器打开 /etc/locale.conf 文件：vi /etc/locale.conf 在编辑器中，找到并定位到 LANG= 行。如果该行不存在，请在文件的末尾添加以下内容以设置默认的中文语言环境：LANG=zh_CN.utf8 3）保存文件按下 Esc 键退出插入模式输入 :wq，然后按下 Enter 键，以保存文件并退出 vi 编辑器 4）重启Linux系统命令：sudo reboot 说明：在更新语言环境配置后，重新启动系统以应用更改 5）确认设置成功命令：locale 说明：如果 LANG 返回值为 zh_CN.utf8，说明设置成功

临时方案

1）登录终端

打开终端，并使用管理员权限登录到系统。

2）设置默认语言环境

命令：sudo localectl set-locale LANG=zh_CN.utf8
说明：这个命令将更新系统的语言环境配置文件，将默认语言设置为 zh_CN.utf8

3）重新访问终端

为了使语言环境的更改生效，请关闭终端，重新登录访问Linux系统

4）确认设置成功

命令：locale
说明：如果 LANG 返回值包含.utf8，说明设置成功

永久方案

1）登录终端

打开终端，并使用管理员权限登录到系统。

2）修改配置

使用 vi 编辑器打开 /etc/locale.conf 文件：vi /etc/locale.conf
在编辑器中，找到并定位到 LANG= 行。如果该行不存在，请在文件的末尾添加以下内容以设置默认的中文语言环境：LANG=zh_CN.utf8

3）保存文件

按下 Esc 键退出插入模式
输入 :wq，然后按下 Enter 键，以保存文件并退出 vi 编辑器

4）重启Linux系统

命令：sudo reboot
说明：在更新语言环境配置后，重新启动系统以应用更改

5）确认设置成功

命令：locale
说明：如果 LANG 返回值为 zh_CN.utf8，说明设置成功

3. 安装缺失字体

本文以 CentOS 系统为例。其他 Linux 版本安装步骤有所不同，请根据你的系统需求自行调整。

1）确认模板显示异常的字体。

2）先为服务器安装字体管理工具，才能安装字体。

3）自行获取字体文件，将字体安装到Linux、Tomcat、JDK中。

3.1 检测缺失字体

1）检查缺失字体

使用设计器打开有问题的模板文件。查看有问题的字体部分，确认可能缺失的字体。例如缺失黑体。

2）获取字体文件

请从信任的来源获取所需的字体文件，帆软不提供此部分资源。

通常字体文件是以 .ttf 或 .otf 扩展名结尾的文件。

3.2 安装字体管理工具

如需在Linux系统安装字体，必须确保系统中已有字体管理工具。

请根据你的服务器网络环境，选择合适的方式安装字体管理工具。

服务器	操作
外网	1）安装字体渲染库命令：sudo yum install fontconfig 说明：这个命令将安装字体渲染库，以便在CentOS 7系统上启用字体渲染功能和管理字体 2）安装字体目录索引生成工具命令：sudo yum install ttmkfdir 说明：这个命令将安装一个用于创建字体目录索引文件的命令行工具，可以确保系统能够正确地识别和渲染所安装的字体文件
内网	1）下载fontconfig和ttmkfdir安装包请根据你使用的 Linux 系统发行版和版本，自行查找相关安装包资源，帆软不提供此部分资源将fontconfig和ttmkfdir安装包上传到服务器中。本示例上传到/home/test文件夹下 2）安装字体管理工具进入安装包所在目录（请自行调整目录位置）：cd /home/test 安装fontconfig（请自行调整安装包名称）：rpm -ivh fontconfig-2.13.0-4.3.el7.x86_64.rpm --nodeps --force 安装ttmkfdir（请自行调整安装包名称）：rpm -ivh ttmkfdir-3.0.9-42.el7.x86_64.rpm --nodeps --force

服务器

操作

外网

1）安装字体渲染库

命令：sudo yum install fontconfig
说明：这个命令将安装字体渲染库，以便在CentOS 7系统上启用字体渲染功能和管理字体

2）安装字体目录索引生成工具

命令：sudo yum install ttmkfdir
说明：这个命令将安装一个用于创建字体目录索引文件的命令行工具，可以确保系统能够正确地识别和渲染所安装的字体文件

内网

1）下载fontconfig和ttmkfdir安装包

请根据你使用的 Linux 系统发行版和版本，自行查找相关安装包资源，帆软不提供此部分资源
将fontconfig和ttmkfdir安装包上传到服务器中。本示例上传到/home/test文件夹下

2）安装字体管理工具

进入安装包所在目录（请自行调整目录位置）：cd /home/test
安装fontconfig（请自行调整安装包名称）：rpm -ivh fontconfig-2.13.0-4.3.el7.x86_64.rpm --nodeps --force
安装ttmkfdir（请自行调整安装包名称）：rpm -ivh ttmkfdir-3.0.9-42.el7.x86_64.rpm --nodeps --force

3.3 安装字体-Linux

本示例将字体安装到/usr/local/share/fonts目录下，该目录一般需要较高用户权限方可安装，请酌情调整。

	步骤	操作
1	准备字体文件	请从信任的来源获取所需的字体文件，帆软不提供此部分资源通常字体文件是以 .ttf 或 .otf 扩展名结尾的文件
2	上传字体文件	在系统上创建一个目录来存储字体文件。通常在 /usr/local/share/fonts 目录下创建一个子目录以存放新的字体文件。 sudo mkdir -p /usr/local/share/fonts/myfonts 赋予文件夹权限 chmod -R 755 /usr/local/share/fonts/myfonts 上传字体文件将准备的字体文件上传到该文件夹中
3	更新字体缓存	命令：sudo fc-cache -f -v 说明：运行该命令以更新系统的字体缓存，这将使系统识别并注册新安装的字体
4	验证字体安装	命令：fc-list 说明：运行该命令来列出系统中已安装的字体列表，你将在输出中看到你刚刚安装的字体文件

3.4 安装字体-Tomcat&JDK

	步骤	操作
1	准备字体文件	请从信任的来源获取所需的字体文件，帆软不提供此部分资源通常字体文件是以 .ttf 或 .otf 扩展名结尾的文件
2	关闭工程	请参考「关闭或重启FineReport工程」文档，关闭工程
3	上传字体文件	1）将字体文件上传至%Tomcat_HOME%/webroot/WEB-INF/fonts文件夹中如无相关文件夹，请自行创建 2）将字体文件上传至%JDK_HOME%/jre/lib/fonts文件夹中请确保所上传到的JDK，是Tomcat工程所调用的JDK 如为帆软提供的Tomcat部署包，位置在%Tomcat_HOME%/jdk/jre/lib/fonts 如无相关文件夹，请自行创建
4	重启工程	请参考「关闭或重启FineReport工程」文档，启动工程

已经是第一篇

已经是最后一篇

有帮助
没帮助
只是浏览

中文（繁體） English 日本語

中文（简体）

Linux系统设置中文语言环境和字体