トラブルシュート
ビルドエラーの多くはTeX環境や不足パッケージに関連。このガイドは症状別に解決策を提示します。
診断コマンド
Terminal: 以下を実行。全てがパスを返せばOK
TeX64内: 設定 > 環境 で環境状態を確認
TeX 環境の問題
latexmk not found
原因：TeX環境未インストールまたはPATH未設定
解決：
- MacTeXをインストール: https://www.tug.org/mactex/
- または: sudo tlmgr install latexmk
- 確認: which latexmk
- TeX64を再起動
lualatex not found
原因：TeX環境未インストール
解決：MacTeXをインストール（lualatexを含む）
latexindent not found
解決：
注：latexindentは任意（コードフォーマット用）、ビルドには不要
synctex not found
解決：MacTeXに含まれる。なければ: sudo tlmgr install synctex
synctexなしではSyncTeXナビゲーション動作しない
.styパッケージが見つからない
エラー：「File xxx.sty not found」
解決：
検索：
PATHの問題
echo $PATH で確認
/Library/TeX/texbin が含まれるべき。Homebrewなら /opt/homebrew/bin
解決：~/.zshrc に追加：export PATH="/Library/TeX/texbin:$PATH"
Terminal と TeX64 を再起動
ビルドの問題
ビルド失敗
ビルド出力パネルでエラーを確認。エラーをクリックでソース行にジャンプ
一般的な原因：LaTeXコマンドのタイポ、括弧の不一致、パッケージ不足
Tip：AI（Axiom）にエラーを貼り付けて診断
PDF更新されない
PDFはビルド成功時のみ更新。エラーがないか確認
ツールバーのビルドボタンで再ビルド
ビルドが遅い
画像が多いプロジェクトは時間がかかる
latexmkはインクリメンタルビルド（2回目以降は高速）
初回ビルドはパッケージダウンロードで遅い場合がある
SyncTeXの問題
動作しない
synctex がインストールされているか確認
再ビルドして .synctex.gz を生成
設定 > 環境 で緑チェック確認
ジャンプが不正確
一部パッケージがソースマッピングに干渉
マルチファイルプロジェクト：\input/\include パスが正しいか
macOSの問題
Gatekeeper
「開発元が未確認」→ Control+クリック → 開く、またはシステム設定 > プライバシーとセキュリティ > 許可
Screen Recording Permission（OCR用）
システム設定 > プライバシーとセキュリティ > 画面収録 > TeX64有効化
TeX64再起動が必要な場合あり
App is Damaged
DMGを再ダウンロード。アーキテクチャが正しいか確認（Apple Silicon vs Intel）
AI/Axiomの問題
AI機能が使えない
まずサインインを確認し、アカウント > 請求 を確認
AI（チャット・補完）は全プランで利用可能で、Freeにも毎月の少量トライアルが含まれます。動かなくなる最も多い原因は、月間トークン枠を使い切った（または支払い遅延）ことです。チャージするか次のサイクルをお待ちください。
トークン残量確認（アカウント > 使用量）
インターネット接続確認
レスポンスが遅い/タイムアウト
ネット接続確認
サーバ負荷の可能性、しばらくして再試行
レート制限：30リクエスト/分
アカウントとログイン
Google Login失敗
ネット接続確認。ブラウザキャッシュクリア。再ログイン
サブスクリプション反映されない
数分かかる場合あり
支払い失敗時はStripeポータルで更新
Grace period：支払い失敗後3日間
ギャラリーの問題
投稿数上限：Free=10件、Basic=100件、Pro=500件
1日あたりの投稿上限：10件
画像サイズ上限：20MB。TeXソース上限：500,000文字。タグ上限：8個/投稿
ヘルプを得る
AIチャットでエラーを診断
/feedback でサポートに連絡
含めるべき情報：macOSバージョン、TeX64バージョン、エラーメッセージ、再現手順
エラー診断レポート：Settings > Privacy で有効化可能