修復 Linux 系統下 ONLYOFFICE Desktop 字型模糊問題：實用指南

首先確定哪些地方模糊不清。

如果整個 ONLYOFFICE 視窗看起來模糊，請在變更字型檔案或 Fontconfig 設定之前測試 Linux 顯示縮放。如果只有文件中的文字顯示異常，請檢查該文件是否使用了電腦上缺失或被替換的字體。這些是不同的問題，需要不同的解決方法。

每次變更後，關閉並重新開啟 ONLYOFFICE，然後在相同的視窗大小下檢查同一份文件。這種簡單的對比方法可以幫助您避免一次更改多個設置，並清楚地確定是哪項更改起了作用。如果您不確定問題是否僅限於此編輯器，請在同一顯示器上的其他桌面應用程式中比較小文字。

1. 檢查桌面顯示縮放比例和會話類型

選單、工具列標籤和文件文字邊緣模糊通常表示顯示縮放或應用程式的顯示方式有問題。在某些 Linux 桌面和圖形組合中，分數縮放（例如 125% 或 150%）可能是一個影響因素。但這並不能證明 ONLYOFFICE 有普遍缺陷：顯示伺服器、桌面環境、軟體包格式、圖形驅動程式和應用程式版本都會影響結果。

為了快速測試，請開啟桌面環境的顯示設置，並暫時切換到標準縮放比例，例如 100% 或 200%（如果這些選項適合您的螢幕）。如果您的桌面需要，請登出並重新登錄，然後再次啟動 ONLYOFFICE。在 GNOME 中，相關設定位於「設定」>「顯示」下；其他桌面環境的名稱可能不同，且提供的縮放比例增量也可能不同。如果應用程式在標準縮放比例下變得清晰，則模糊問題可能與分數縮放或顯示路徑有關。作為實用的解決方法，請選擇最清晰可用的縮放比例，或查看您桌面環境的最新文檔，以了解支援的 HiDPI 選項。

您可以使用終端命令來識別會話類型echo "$XDG_SESSION_TYPE"。結果通常為“會話類型wayland”或“會話x11類型”。此命令本身並不能診斷圖形堆疊，但如果您需要比較不同會話的行為或報告可重現的問題，它會提供有用的信息。請勿在未查閱已安裝 GNOME 版本的文件的情況下複製啟用實驗性分數縮放功能的舊版 GNOME 指令；可用設定會隨時間而變化。

ONLYOFFICE 桌面編輯團隊的一份報告記錄了一個 GNOME 45 Wayland 系統在 125% 縮放比例下出現的特定問題：介面和文件模糊不清，而 KDE Wayland 系統則表現出不同的行為。請將此報告視為症狀可能與環境相關的證據，而非適用於所有 Linux 系統的保證解決方案。請參閱ONLYOFFICE 關於 GNOME 縮放比例的報告。

2. 將介面縮放與文件縮放分開

ONLYOFFICE 在 Linux 系統上提供應用程式介面縮放選項，其版本歷史記錄顯示支援 125%、150% 和 175% 等介面縮放比例。具體設定可能因版本而異。請開啟應用程式設置，尋找介面或應用程式縮放控制選項；如果標籤或位置不同，請查閱您目前安裝版本的說明文檔，而不是依賴舊版本的選單路徑。

僅更改應用程式介面縮放比例進行測試，然後根據提示重新啟動編輯器。介面縮放會改變應用程式控制項的大小。文件縮放會改變頁面在編輯器中的顯示大小。增大文件縮放比例可以使文字更易於閱讀，但無法修復工具列文字模糊或整個視窗解析度過低的問題。相反，減少介面縮放比例可能會使控制在某些設定下更清晰，但在其他設定下又使其過小而難以使用。選擇一個仍然清晰可讀的設置，並比較工具列和頁面。

作為背景訊息，ONLYOFFICE桌面編輯器的更新日誌記錄了其在Linux系統下支援125%和175%的介面縮放比例，並且在先前的版本中支援150%的縮放比例。本文撰寫之時，更新日誌中列出的版本為9.4.0，發佈於2026年5月19日。該頁面並未說明每個比例的桌面縮放在所有Linux發行版上都能完美運作。

3. 檢查文件是否使用了缺少的字體

如果選單清晰銳利，但某個文件中的字母模糊不清、異常寬大或明顯不同，請檢查其字體。文件可能使用了 Linux 系統中未安裝的字型。此時，編輯器必須顯示替代字體，這可能會改變字母形狀、換行符、頁碼和間距。不同的佈局與螢幕渲染模糊不同，但替代字體可能會使文字看起來異常，足以被誤認為是渲染問題。

在終端機中，使用 Fontconfig 的匹配工具檢查文件使用的字型系列。例如：

fc-match Arial

此操作會列印 Fontconfig 中與該字型系列相符的字型。如果要檢查多字字體名稱，請將其用引號括起來，例如 `<font-name>` fc-match "Liberation Serif"。替換結果並不一定意味著 ONLYOFFICE 在其渲染管線的每個部分都使用完全相同的備用字體；這只是對 Linux 字體系統可用字體的一次實際檢查。

從可信任來源安裝所需的字體，並確保其許可證允許您使用。 ONLYOFFICE 文件會記錄每個使用者的字型位置，例如 `<path>`~/.local/share/fonts和系統層級/usr/share/fonts/字型目錄。對於個人安裝，請將受支援的字體檔案複製到 `<path>` 的子資料夾中~/.local/share/fonts，然後使用 `<command>` 命令刷新使用者字體快取fc-cache -f。發行版軟體套件或其圖形化字體管理器可能更安全、更便捷，尤其對於系統字體而言。避免從未知網站下載字型包或替換系統字型目錄。

安裝字體後，請完全關閉並重新啟動 ONLYOFFICE。 ONLYOFFICE 官方的字型添加說明也提到，安裝字型後需要重新啟動編輯器。重新開啟同一個文件，檢查所選字體是否已出現在字體清單中，以及文字佈局是否符合預期。

4. 僅當新增或變更字體時才刷新字體發現

Fontconfig 用於維護字型資訊和快取檔案。如果您剛剛安裝、刪除或更新了字體，但應用程式仍然無法識別更改，請刷新快取並重新啟動 ONLYOFFICE：

fc-cache -f

在全域安裝字型的系統中，發行版的軟體套件管理器可能會在安裝過程中更新字型快取。運行此命令是一個合理的刷新步驟，但它無法修復由部分顯示縮放、合成器或圖形驅動程式引起的模糊問題。請勿先刪除 Fontconfig 快取目錄。 Fontconfig使用者文件描述了配置和快取位置，並指出某些舊的使用者級位置已被棄用。

5. 更新編輯器並與乾淨的文件進行比較

如果問題影響到整個編輯器在正常縮放等級下的顯示，請使用您目前使用的支援安裝頻道更新 ONLYOFFICE 桌面編輯器，然後重新測試。 ONLYOFFICE 官方入門頁面提供了 Linux 安裝指南的連結。 AppImage 使用者需要根據AppImage 官方說明下載更新的 AppImage 版本進行更新。故障排除時，請避免混用來自不同管道的軟體包；請先確認您從應用程式選單或終端啟動的是哪個版本。

現在建立一個使用常用字體的空白文檔，並將其與受影響的文件進行比較。如果空白文件清晰，而某個文件模糊，則重點檢查該文件的字體選擇、嵌入圖像和縮放設定。如果所有檔案和應用程式的每個部分仍然模糊，則問題可能出在縮放或 Linux 圖形/顯示路徑上。一次性匯出為 PDF 可以幫助您區分螢幕預覽和文件輸出，但這並非完整的螢幕渲染測試：PDF 檢視器和印表機使用各自的渲染路徑。

選擇與症狀相符的解決方案

選單、工具列和頁面看起來都很柔和：將標準桌面縮放比例與您目前的縮放比例進行比較，然後單獨測試 ONLYOFFICE 的介面縮放。
只有一個文件看起來有問題：使用fc-match檢查指定的字體，如果需要，安裝授權字體，刷新發現，然後重新啟動編輯器。
只有文件文字太小，沒有模糊：調整文件縮放以提高可讀性；不要將縮放視為系統字體渲染修復。
如果經過以下測試後模糊問題仍然存在：請記錄 ONLYOFFICE 版本、發行版、軟體包類型、桌面環境、會話類型、縮放比例、顯示分辨率，以及模糊是否會影響選單、頁面或兩者都影響。僅當樣本文件不包含任何私人資訊時才提供。

沒有一個單一的 Linux 字體渲染開關可以解決所有問題。可靠的判斷標準是可重複的比較：相同的文字在適當的縮放比例下清晰可見，預期的字體可用，並且文件佈局保持正確。如果更改系統縮放比例可以解決視窗顯示問題，但會導致其他應用程式無法正常使用，請記錄此情況，並將環境詳情報告給 ONLYOFFICE 專案或您的發行版支援管道，而不是進行大範圍的、永久性的字體配置更改。