結城浩: ChatGPTにまとめてもらったものです。

macOS での TeX Live バージョンアップ(2020 → 2025)手順メモ

macOS Sequoia 15.4.1 上で、手動インストールされていた TeX Live 2020 を TeX Live 2025 にバージョンアップした記録です。Homebrew ではなく、TeX Live 公式インストーラを使いました。

対象:macOS 上で TeX Live を利用しており、公式インストーラでアップグレードを行いたい方


✅ 前提環境

  • OS:macOS Sequoia 15.4.1
  • 旧 TeX Live:2020(/usr/local/texlive/2020
  • 新 TeX Live:2025(/usr/local/texlive/2025
  • ローカルツリー:/usr/local/texlive/texmf-local(継続使用)
  • pdflatex などは /usr/local/bin/ 経由で使用中
  • Homebrew では TeX Live を管理していない

🔍 事前確認ポイント

  • which pdflatex で旧バージョンがどこから実行されているか確認
  • ls -l /usr/local/bin/pdflatex で、旧バージョンのシンボリックリンクを確認
  • brew list | grep texlive で、Homebrew でのインストール有無を確認(入っていれば削除推奨)

📦 インストール手順(手動)

  1. 公式サイトから TeX Live インストーラを取得:

    wget http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
    tar -xzf install-tl-unx.tar.gz
    cd install-tl-*
    sudo ./install-tl -gui
    
  2. GUI で以下のように設定:

    • インストール先:/usr/local/texlive/2025
    • texmf-local/usr/local/texlive/texmf-local(引き継ぎ)
    • デフォルト用紙サイズ:A4
    • シンボリックリンク作成:チェックを入れる(重要)
    • スキーム:full(すべてインストール)
  3. インストール完了後:

    pdflatex --version
    # → "TeX Live 2025" を確認
    which pdflatex
    # → /usr/local/bin/pdflatex または /Library/TeX/texbin を確認
    

🔄 パスが旧バージョンのままなら

sudo tlmgr path add

これで /usr/local/bin/ に最新のバイナリがリンクされます。


🛠 初回更新チェック

sudo tlmgr update --self --all

📁 texmf-local の利用確認

kpsewhich -var-value=TEXMFLOCAL
# → /usr/local/texlive/texmf-local

必要に応じて:

sudo mktexlsr

🧹 古いバージョンの削除(任意)

sudo rm -rf /usr/local/texlive/2020
sudo rm -rf /usr/local/texlive/2015  # など不要な分

📝 補足

  • Homebrew 版 TeX Live と公式インストーラ版は 併用しない方がよい
  • tlmgr を使いたい場合は公式版が推奨
  • GUI の TeX Live Utility も引き続き利用可能(/Applications/TeX Live Utility)

✅ 状態確認チェックリスト

確認内容 コマンド例 確認すべきこと
バージョン確認 pdflatex --version "TeX Live 2025" を含むこと
実行パス確認 which pdflatex /usr/local/texlive/2025/... または /Library/TeX/texbin
ローカルツリー kpsewhich -var-value=TEXMFLOCAL /usr/local/texlive/texmf-local
パッケージ更新 sudo tlmgr update --self --all "no updates available" 等

TeX Live 環境を整理しておくことで、将来のアップグレードやトラブルシュートも安心して行えます。

original gist

(2025年5月14日)