適用物件：本文為第三方解決方案或非產品相關操作指南，僅提供給具備自主開發能力的使用者使用。
本文僅面向Linux伺服器中非維運平台部署的帆軟專案。
維運平台部署的專案，在工程外掛目錄/customlib/fonts資料夾中，可存放客戶自訂的字體檔案，等同於直接放置在工程的/usr/share/fonts下。
1. 概述
1.1 問題描述
工程部署在Linux 系統中時，有時我們存取工程會遇到中文亂碼。
Linux 伺服器匯出文字重疊。
匯出 pdf 時圖表裏的中文變成框框。
插入斜線亂碼，斜線為方框。
1.2 原因分析
出現這個情況有多種原因：
1）工程所在的Linux伺服器，沒有設定中文為預設語言。
2）工程所在的Linux伺服器，沒有安裝範本對應的字體包。
注：需要排查叢集全部工程節點所在伺服器、使用者用戶端環境。
2. 設定Linux伺服器預設語言環境
本文以 CentOS7 系統為例。其他 Linux 版本安裝步驟有所不同，請根據你的系統需求自行調整。
1）先確認伺服器的預設語言環境是什麼，以及是否有中文語言環境。
2）如果沒有中文語言環境，需要先安裝中文語言環境。
3）有中文語言環境的情況下，可設定中文為預設語言環境。
2.1 查看當前預設語言和支援語言環境
1）查看當前系統預設語言環境
命令：locale
回傳值：將顯示當前的語言環境變數，其中 LANG 表示預設字元編碼。
如果.utf8，說明預設語言為中文，字元編碼為UTF-8，一切正常，無需繼續查看本章其他內容，跳到下一章即可。
如果 LANG 值為其他，則需要繼續進行本章其他內容。
2）查看當前系統是否支援中文語言
語句：locale -a | grep zh_CN
回傳值：該命令會列出系統中所有可用的中文語言環境
如果回傳值中有zh_CN.utf8，說明系統已安裝支援中文的語言環境。
如果回傳值中沒有zh_CN.utf8，則需要先安裝中文語言。
2.2 安裝中文語言環境
本文以支援外網存取的伺服器為例，內網環境請自行查閱資料調整安裝方法。
命令：yum install kde-l10n-Chinese
說明：這個命令將安裝中正文地化包。根據你的系統和包管理器，可能需要確認安裝程式中的提示資訊。
2.3 設定中文為預設語言環境
臨時方法無需重啟Linux系統，只需要關閉重新開啟終端即可。
永久方案需要重啟Linux系統，請按需選擇。
2.3.1 臨時設定預設語言環境
1）設定預設語言環境
命令：sudo localectl set-locale LANG=zh_CN.utf8
說明：這個命令將更新系統的語言環境配置檔案，將預設語言設定為 zh_CN.utf8。
2）重新存取終端
為了使語言環境的更改生效，建議關閉終端，重新登入存取系統。
3）確認設定成功
命令：locale
說明：如果回傳值.utf8，說明設定成功。
2.3.2 永久設定預設語言環境
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. Linux伺服器安裝字體
本文以 CentOS7 系統為例。其他 Linux 版本安裝步驟有所不同，請根據你的系統需求自行調整。
1）先確認範本顯示異常的字體，並確認伺服器中是否安裝該字體。
2）需要先為伺服器安裝字體管理工具，才能安裝字體
3）自行獲取字體檔案，將字體安裝到伺服器中。
3.1 檢查缺失字體
1）檢查缺失字體
儀表板中亂碼的部分用的什麼字體，為缺失字體。
假設分組表匯出後，表頭亂碼，表頭用的為黑體，則缺少黑體字體包。
2）獲取字體檔案
請從信任的來源獲取所需的字體檔案，帆軟不提供此部分資源。
通常字體檔案是以 .ttf 或 .otf 擴展名結尾的檔案。
3.2 安裝字體管理工具
如需在Linux系統安裝字體，必須確定系統中已有字體管理工具。
本文以支援外網存取的伺服器為例，內網環境請自行查閱資料調整安裝方法。
1）安裝字體渲染庫
命令：sudo yum install fontconfig
說明：這個命令將安裝字體渲染庫，以便在CentOS 7系統上啟動字體渲染功能和管理字體。
2）安裝字體目錄索引生成工具
命令：sudo yum install ttmkfdir
說明：這個命令將安裝一個用於建立字體目錄索引檔案的命令行工具，可以確定系統能夠正確地識別和渲染所安裝的字體檔案。
3.3 安裝字體
1）下載字體檔案
請從信任的來源獲取所需的字體檔案，帆軟不提供此部分資源。
通常字體檔案是以 .ttf 或 .otf 擴展名結尾的檔案。
2）上傳字體檔案
在系統上建立一個目錄來儲存字體檔案。通常在 /usr/share/fonts 目錄下建立一個子目錄以存放新的字體檔案。
sudo mkdir -p /usr/share/fonts
賦予資料夾權限
chmod -R 755 /usr/share/fonts
上傳字體檔案
將本地的字體檔案上傳到該資料夾中。
3）更新字體快取
命令：sudo fc-cache -f -v
說明：運作該命令以更新系統的字體快取，這將使系統識別並註冊新安裝的字體。
4）驗證字體安裝
命令：fc-list
說明：運作該命令來列出系統中已安裝的字體列表，你將在匯出中看到你剛剛安裝的字體檔案。
