結城浩: 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 でのインストール有無を確認(入っていれば削除推奨)
📦 インストール手順(手動)
-
公式サイトから 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
-
GUI で以下のように設定:
- インストール先:
/usr/local/texlive/2025
texmf-local
:/usr/local/texlive/texmf-local
(引き継ぎ)- デフォルト用紙サイズ:A4
- シンボリックリンク作成:チェックを入れる(重要)
- スキーム:
full
(すべてインストール)
- インストール先:
-
インストール完了後:
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 環境を整理しておくことで、将来のアップグレードやトラブルシュートも安心して行えます。
(2025年5月14日)