Linux版ONLYOFFICEデスクトップでフォントがぼやける問題を解決する：実践ガイド

まず、何がぼやけているかを特定することから始めましょう。

ONLYOFFICEウィンドウ全体がぼやけて見える場合は、フォントファイルやFontconfigの設定を変更する前に、Linuxのディスプレイスケーリングをテストしてください。ドキュメント内のテキストのみが正しく表示されない場合は、ドキュメントで使用されているフォントがコンピュータに存在しないか、代替フォントに置き換えられていないかを確認してください。これらは異なる問題であり、それぞれ異なる解決策が必要です。

変更を加えるたびにONLYOFFICEを閉じて再度開き、同じウィンドウサイズで同じドキュメントを確認してください。この簡単な比較により、複数の設定を一度に変更してしまうことを防ぎ、どの変更が重要だったかを明確にすることができます。問題がエディター固有のものかどうか不明な場合は、同じディスプレイ上の別のデスクトップアプリケーションで小さなテキストを比較してみてください。

1. デスクトップの表示スケールとセッションの種類を確認します。

メニュー、ツールバーのラベル、ドキュメントのテキストの輪郭がぼやける場合、多くの場合、ディスプレイのスケーリングやアプリケーションの表示方法に問題があります。125%や150%といった分数スケーリングは、Linuxのデスクトップ環境やグラフィック環境の組み合わせによっては問題となることがあります。これはONLYOFFICEに共通する不具合の証拠ではありません。ディスプレイサーバー、デスクトップ環境、パッケージ形式、グラフィックドライバー、アプリケーションのバージョンなど、様々な要因が結果に影響を与えます。

簡単なテストを行うには、デスクトップ環境のディスプレイ設定を開き、画面に合う場合は一時的に100%または200%などの標準スケールに切り替えてください。デスクトップによってはサインアウトして再度サインインする必要がある場合があり、その後ONLYOFFICEを再度起動してください。GNOMEでは、該当する設定は「設定」>「ディスプレイ」にあります。他のデスクトップでは名称が異なり、スケールの増分も異なる場合があります。標準スケールでアプリケーションが鮮明になる場合は、ぼやけの原因はおそらく分数スケールまたはディスプレイパスに関連しています。実用的な回避策として、最も鮮明なスケールを選択するか、サポートされているHiDPIオプションについてデスクトップの最新のドキュメントを確認してください。

ターミナルから を実行すると、セッションの種類を識別できますecho "$XDG_SESSION_TYPE"。結果は一般的にwaylandまたは になりx11ます。これだけではグラフィックス スタックを診断することはできませんが、セッション間の動作を比較したり、再現可能な問題を報告したりする必要がある場合に役立つ情報が得られます。インストールされている GNOME バージョンのドキュメントを確認せずに、実験的な分数スケーリング機能を有効にする古い GNOME コマンドをコピーしないでください。利用可能な設定は時間の経過とともに変更されています。

ONLYOFFICEデスクトップエディターのレポートには、GNOME 45 Waylandで125%の分数スケーリングを使用した場合に、インターフェースとドキュメントがぼやけて表示されるという特定のケースが報告されています。一方、KDE ​​Waylandでは異なる動作が報告されています。このレポートは、症状が環境によって異なる可能性があることを示す証拠として捉えてください。すべてのLinuxシステムで確実に解決できるとは限りません。GNOMEの分数スケーリングに関するONLYOFFICEレポートを参照してください。

2. インターフェースのスケーリングとドキュメントのズームを分離する

ONLYOFFICEはLinux版でアプリケーションインターフェースのスケーリングオプションを提供しており、リリース履歴には125%、150%、175%などのスケーリング値がサポートされていることが記録されています。具体的な設定方法はリリースによって異なる場合があります。アプリケーションの設定を開き、インターフェースまたはアプリケーションのスケーリング設定を探してください。ラベルや場所が異なる場合は、古いリリースのメニューパスに頼るのではなく、インストールされているバージョンのヘルプを参照してください。

テストのためにアプリケーションインターフェイスのスケールのみを変更し、必要に応じてエディタを再起動してください。インターフェイスのスケーリングは、アプリケーションコントロールのサイズを変更します。ドキュメントのズームは、エディタ内でページが表示されるサイズを変更します。ドキュメントのズームを大きくすると文字が読みやすくなりますが、ツールバーのテキストがぼやけていたり、ウィンドウ全体の解像度が低い場合は修正されません。逆に、インターフェイスのスケールを小さくすると、設定によってはコントロールが鮮明になる一方で、小さすぎて使用できなくなる場合があります。読みやすい設定を選択し、ツールバーとページの両方を比較してください。

背景情報として、ONLYOFFICEデスクトップエディターの変更履歴には、Linux向けに125%と175%のインターフェーススケーリングがサポートされていること、そして以前のリリースでは150%のサポートが記載されています。この記事を確認した時点で変更履歴に記載されているバージョンは9.4.0で、2026年5月19日にリリースされました。ただし、このページでは、すべてのデスクトップスケールがすべてのディストリビューションで同様に機能することが証明されているわけではありません。

3. 文書が不足しているフォントを代替しているかどうかを確認します。

メニューは鮮明に見えるのに、特定の文書の文字がぼやけていたり、異常に幅が広​​かったり、明らかに異なっていたりする場合は、フォントファミリーを確認してください。文書で指定されているフォントが、お使いのLinuxシステムにインストールされていない場合があります。その場合、エディタは代替フォントを表示する必要があり、文字の形状、改行、ページ数、間隔などが変わる可能性があります。レイアウトの違いは画面レンダリングのぼやけとは異なりますが、代替フォントによってテキストが不自然に見え、レンダリングの問題と誤解されることがあります。

ターミナルで、Fontconfigのマッチングツールを使用して、ドキュメントで使用されているフォントファミリーを確認します。例：

fc-match Arial

これは、そのフォントファミリーに対して Fontconfig が一致したフォントを表示します。複数の単語からなるフォント名をチェックする場合は、引用符で囲んでください (例: ) fc-match "Liberation Serif"。代替結果が表示されたとしても、ONLYOFFICE がレンダリングパイプラインのすべての部分でまったく同じフォールバックを使用しているとは限りません。これは、Linux フォントシステムで使用可能なフォントを実用的にチェックするためのものです。

信頼できるソースから必要なフォントをインストールし、ライセンスが使用を許可していることを確認してください。ONLYOFFICE は、ユーザーごとのフォントの場所 (~/.local/share/fontsやシステム全体の/usr/share/fonts/ディレクトリなど) を文書化しています。個人用インストールの場合、サポートされているフォント ファイルを のサブフォルダにコピーし~/.local/share/fonts、 を使用してユーザー フォント キャッシュを更新しますfc-cache -f。特にシステム フォントの場合は、ディストリビューション パッケージまたはそのグラフィカル フォント マネージャーを使用する方が安全で簡単です。不明なサイトからフォント バンドルをダウンロードしたり、システム フォント ディレクトリを置き換えたりすることは避けてください。

フォントをインストールした後は、ONLYOFFICEを完全に終了して再起動してください。ONLYOFFICEの公式フォント追加手順書にも、インストール後にエディタを再起動するように記載されています。同じファイルを再度開き、選択したフォントがフォント一覧に表示されているか、テキストレイアウトが期待どおりになっているかを確認してください。

4. フォントが追加または変更された場合にのみ、フォントの検出を更新する。

Fontconfigはフォント情報とキャッシュファイルを管理します。フォントをインストール、削除、または更新したにもかかわらず、アプリケーションが変更を反映しない場合は、キャッシュを更新してONLYOFFICEを再起動してください。

fc-cache -f

フォントをグローバルにインストールしたシステムでは、ディストリビューションのパッケージマネージャがインストールの一環としてフォントキャッシュを更新する場合があります。このコマンドを実行することは適切な更新手順ですが、分数表示スケーリング、コンポジタ、またはグラフィックドライバによって引き起こされるぼやけは修正されません。最初の対応としてFontconfigキャッシュディレクトリを削除しないでください。Fontconfigのユーザーマニュアルには、設定とキャッシュの場所が記載されており、一部の古いユーザーごとの場所が非推奨になっていることが示されています。

5. エディターを更新し、クリーンなドキュメントと比較する

通常の拡大縮小時にエディタ全体に問題が発生する場合は、現在使用しているサポート対象のインストールチャネルを使用して ONLYOFFICE デスクトップ エディターを更新し、再度テストしてください。ONLYOFFICE の公式スタートガイドページには、Linux インストール手順へのリンクがあります。AppImage ユーザーは、公式の AppImage の手順に従って、より新しい AppImage をダウンロードして更新する必要があります。トラブルシューティング中は、異なるチャネルのパッケージを混在させないようにしてください。まず、アプリケーション メニューまたはターミナルから起動するビルドを確認してください。

次に、インストールされている一般的なフォントを使用して空白のドキュメントを作成し、影響を受けているファイルと比較します。空白のドキュメントは鮮明なのに、一方のファイルが鮮明でない場合は、そのファイルのフォント、埋め込み画像、ズームに注目してください。すべてのファイルとアプリケーションのすべての部分がぼやけたままの場合は、スケーリングまたはLinuxのグラフィック/表示パスに問題がある可能性があります。一度PDFにエクスポートすると、画面上のプレビューとドキュメント出力を区別するのに役立ちますが、これは完全な画面レンダリングテストではありません。PDFビューアとプリンターは独自のレンダリングパスを使用するためです。

症状に合った解決策を選択してください

• メニュー、ツールバー、ページ全体がぼやけて見えるので、標準のデスクトップスケールと現在のスケールを比較し、ONLYOFFICEのインターフェースのスケーリングを個別にテストしてください。
• 問題のあるドキュメントは1つだけのようです。指定されたフォントを確認し、必要に応じてライセンスされたフォントをインストールfc-matchし、検出を更新して、エディタを再起動してください。
• 文書の文字が小さすぎるだけで、ぼやけているわけではありません。読みやすさを考慮して文書のズームを調整してください。ズームはシステムのフォントレンダリングの修復とはみなさないでください。
• 以下のテスト後もぼかしが解消されない場合は、 ONLYOFFICEのバージョン、配布元、パッケージの種類、デスクトップ環境、セッションの種類、拡大縮小率、表示解像度、およびぼかしがメニュー、ページ、またはその両方に影響するかどうかを記録してください。サンプルファイルは、個人情報が含まれていない場合のみ添付してください。

Linuxのフォントレンダリング設定で、あらゆるケースに対応できる万能なスイッチは存在しません。確実な解決策は、再現可能な比較を行うことです。つまり、同じテキストが適切なサイズで鮮明に表示され、期待されるフォントが利用可能で、ドキュメントのレイアウトが正しく維持されていることを確認することです。システムスケールを変更することでウィンドウの問題は解決するものの、他のアプリケーションが使い物にならなくなる場合は、その点をメモしておき、広範囲にわたる恒久的なフォント設定変更を行うのではなく、環境の詳細をONLYOFFICEプロジェクトまたはディストリビューションのサポート窓口に報告してください。

情報源

• ONLYOFFICE：デスクトップエディタに新しいフォントを追加
• ONLYOFFICEデスクトップエディターの変更履歴
• Fontconfigのユーザー向けドキュメント
• ONLYOFFICEデスクトップエディタにおけるGNOMEの分数スケーリングに関する問題