> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ja/to-2/81-tips-and-tricks-for-troubleshooting-latex.md).

# LaTeXのトラブルシューティングのコツとヒント

LaTeX の問題を特定して解決するのに役立つ、いくつかのヒントとコツがあります。一般的には、次の設定でデバッグすることをおすすめします。 [「最初のエラーで停止」コンパイルモードをオンにした状態](/latex/ja/narejjibsu/149-using-the-stop-on-first-error-compilation-mode.md)、エラーの連鎖を避けられるからです。エラーが発生したら、次の手順で解決できます。

1. **エラーまたは警告がありますか？**

   まずは、Recompile ボタンのすぐ右にある「Logs and output files」アイコンを確認してください。

   ![「Logs and output files」アイコン内の警告インジケーター](/files/c7174846b62941fd9a61f925e9afdce848b0cc58)

   警告メッセージはオレンジ色で表示されます。これは多くの場合、LaTeX が通常とは異なる何かを見つけて自動的に調整したことを知らせるだけです。文書の最終的な見た目に影響しない場合は、通常は無視して構いません。

   たとえば、多くのフロートや余白/スペースの問題は、ユーザーによる修正なしに LaTeX によって修正されます。Overleaf では、次の特別な種類の警告を報告します。 [underfull および overfull box の警告](/latex/ja/narejjibsu/138-understanding-underfull-and-overfull-box-warnings.md#overfull-or-underfull-boxes-are-not-errors)が青色で表示されます。これらのほとんどは安全に無視できますが、文書の確認が必要な箇所を示していることもあります。

   ![「Logs and output files」アイコン内のエラーインジケーター。](/files/62f29b32da539c5659859c32f077f6bdeab52b10)

   エラーメッセージは赤色で表示されます。通常はより問題が大きく、文書の正しいコンパイルを妨げることがあります。致命的なエラーでは、文書をまったくコンパイルできない場合があります。

   一般的なエラーとその解決方法の一覧があります [こちら](/latex/ja/latexno/05-errors.md)。エラーはできるだけ早く修正することをおすすめします。放置すると、将来デバッグが難しい致命的なエラーにつながる可能性があります。
2. **メッセージは特定のエラーや行番号を示していますか？**

   ![行番号が含まれているエラーメッセージ。](/files/fe113add8cfd3d86acaf0c2ffa1b676caf482a9e)

   多くの場合、LaTeX エンジンは正確なエラーを推測し、行番号を示してくれます。上の例では、記号 `_`があり、LaTeX では次のようにエスケープする必要があります。 `\_`。エラーメッセージには、エラーが 29 行目にあることまで示されており、該当行がハイライトされ、問題のある箇所のテキストの抜粋も表示されます。エラーメッセージをクリックすると、ソースコード内でエラーが発生しているファイルと行番号に直接移動できます。

   行番号が示されていない場合は、以下の手順をいくつか試してみてください。
3. **エラー文に手がかりがありますか？**

   ![問題が .bbl ファイルにあることを示すエラーメッセージ。これは参考文献に問題があることを示唆しています。](/files/c3c870f3881a8f81041f274706b7e9907471107c)

   上のエラーメッセージでは行番号が示されていますが、普段編集しているファイルではありません。ここでは、ファイル拡張子 .bbl が、コンパイルを妨げているエラーが BibTeX の問題であることを示す手がかりになります。

    .bib ファイルでハイライトされたテキストを検索すれば、エラーの原因を見つけられます。場合によっては [補助ファイルやログファイルを確認することで](/latex/ja/narejjibsu/150-view-generated-files.md) 、短いメッセージダイアログよりも具体的な情報が得られることがあります。
4. **以前のバージョンと比較して変更を元に戻す**

   以前は問題なくコンパイルできていたなら、最近の編集でプロジェクトにエラーを入れてしまった可能性が高いです。 [履歴機能](/latex/ja/sononotopikku/49-using-the-history-feature.md) を使って最近の変更を元に戻せます。
5. **\end{document} を移動してみる**

   それでもエラーの場所を絞り込めない場合は、メインの .tex ファイルの末尾から `\end{document}` 切り取り、プロジェクトのさまざまな場所に貼り付けてみてください。まずはメインの .tex ファイルから始め、必要であれば、メインファイルで `\input{}` または `\include{}`を使って読み込んでいるサブファイルも同様に試します。プロジェクト/文書の末尾から文書の先頭に向かって、体系的に 1 セクションずつこの作業を繰り返してください。特に、エラーが起こりやすい式や複雑なセクションには注意してください。

   これにより、問題のある箇所を特定できるまで、文書を少しずつより小さな部分に絞り込めます。文書が突然コンパイルされ始めたら、エラーのある箇所を見つけたということです。多くの場合、問題は、単純なコマンドの টাইプミス、エスケープされていない特殊文字、または括弧の不足といった、ごく単純なものです。
6. **コンパイルの「タイムアウト」エラーですか？**

   場合によっては、特定の条件下でタイムアウトによるコンパイルエラーが発生することがあります。これは、当社のサーバーにおけるリソース/コンパイル時間の制限が原因です。無料アカウントと有料アカウントでは時間制限が異なります。文書のコンパイルを [高速化する](/latex/ja/narejjibsu/038-fixing-and-preventing-compile-timeouts.md)ためのヒントがいくつかあります。これらで解決しない場合は、 [サポートリクエスト](https://www.overleaf.com/contact).
7. **「PDF レンダリング」エラーですか？**

   他のオンラインサービスと同様に、Overleaf の使用中に問題が発生することがあります。ブラウザーの状態、ブラウザー拡張機能、サービス提供側の短時間の障害、ネットワーク設定の問題などが原因になる可能性があります。

   接続の問題がある場合、またはエディターや PDF ビューアーの一部が期待どおりに読み込まれない・表示されない場合は、以下のトラブルシューティング手順をお試しください。 [このページ](/latex/ja/narejjibsu/125-resolving-access-loading-and-display-problems.md).
8. **フォーラムを試す**

   行番号が示されておらず、与えられたエラーメッセージも理解できない場合は、お気に入りの検索エンジンにすばやく「コピー＆ペースト」してみると、似た問題に直面した経験のある上級ユーザーからの情報が見つかるかもしれません。TeX 関連の優れたフォーラムには、 [LaTeX Stack Exchange](https://tex.stackexchange.com/) や [LaTeX Community](https://latex.org/forum/).
9. **お問い合わせ**

   最後になりますが、いつでも [サポートリクエスト](https://www.overleaf.com/contact)。問題が LaTeX 固有のものでもサイト固有のものでも、Overleaf を最大限に活用できるよう喜んでお手伝いします。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/ja/to-2/81-tips-and-tricks-for-troubleshooting-latex.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.