🧭

25生のためのLaTeX環境構築

に公開8

1. はじめに

えっけんなどで使うことになるLaTeX、なかなか環境構築が面倒だったり難しかったりするかと思います!(私もまあまあ苦戦した)備忘録も兼ねて私の環境構築の方法を皆さんに共有しようと思い記事を書きました。

2. 対象読者

  • LaTeX何もわかんない〜〜〜〜〜
  • なんか変なエラー出る〜〜〜〜〜
  • 無理かも〜〜〜〜〜〜〜〜〜〜〜

3. 私の使用環境

  • macOS(Sequoia 15.4)
  • Homebrew導入済み
  • vscode
  • lualatex

4. Homebrewの導入

HomebrewとはmacOS用のパッケージマネージャーです。パッケージのインストール、アップデート、ゴミを残さない綺麗なアンインストールをこれ一本でターミナルから実行することができます。

ということでこれを使ってこれから色々インストールしていくというわけです。
なのでまずはHomebrewをインストールしましょう!!
まず⌘+Spaceを押してSpotlight検索にターミナルと入力しターミナルを開いてください。

このような画面が出てきたと思います。(2行目が{Userフォルダ名}@{使っているmacの名前} ~ %となっていればok)
そこに以下のコマンドをペーストし実行してください。

ターミナル
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

途中Password?:とパスワードの入力を求められますがログイン時に使うパスワードを入力
ブワーーと色々出てきたら多分okです。そうしたら次にパスを通しましょう。
先ほどのブワーーの最後の方にAdd Homebrew to ~とパスを通してね!みたいなことを言われるので、その下にある2つのコマンドを実行してパスを通しましょう。実行したら念の為にターミナルを再起動して次のステップに行きます。
以下のコマンドを実行してあなたのmacにHomebrewが正しくインストールされているか確認しましょう。

ターミナル
brew -v

Homebrewのバージョンが表示されればインストール完了です。

5. vscode,mactexのインストール

ターミナルにて以下のコマンドを実行してください。

ターミナル
brew install --cask visual-studio-code
brew install --cask mactex-no-gui

6. vscodeの設定を完了する

mactexのインストールにはそこそこ時間がかかるためインストール中にvscode側の準備を終わらせましょう。ターミナルにcodeと入力しvscodeを起動します。
拡張機能のタブを開いて検索バーにlatex workshopと入力し一番上に出てきた拡張機能をインストールしてください。
次にsettings.jsonを設定しましょう。

ここから 右上のアイコンを押すと...
h:300

settings.jsonが開きます。そこに以下のコードをペーストしてください。

settings.json
{
    "latex-workshop.latex.recipes": [
        {
            "name": "lualatex",
            "tools": [
                "lualatex"
            ]
        }
    ],
    "latex-workshop.latex.tools": [
        {
            "name": "lualatex",
            "command": "lualatex",
            "args": [
                "--cmdx",
                "-file-line-error",
                "-synctex=1",
                "-interaction=nonstopmode",
                "-halt-on-error",
                "-output-directory=output",
                "%DOC%"
            ]
        }
    ],
    "latex-workshop.latex.recipe.default": "lualatex",
    "latex-workshop.view.pdf.viewer": "tab",
    "latex-workshop.view.pdf.zoom": "page-width",
    "latex-workshop.latex.autoBuild.run": "onSave",
    "latex-workshop.latex.autoBuild.interval": 500,
    "latex-workshop.latex.outDir": "./output",
}

これでvscode側の設定は完了です。日本語化したかったりテーマを自分好みに変えたかったら拡張機能のタブから自分で色々インストールしてみてください!

7. 実際に書いてみよう!!

いよいよ大詰めです。一旦mactexのインストールが終わっているかターミナルを開いて確認してみましょう。終わってそうな雰囲気だったら一度ターミナルを再起動して、以下のコードを実行して正しくインストールされているか確認しましょう。

ターミナル
lualatex -v

lualatexのバージョンが出てきたら完了です。
pc上の好きなところにlatex用のフォルダを作ってvscodeで開きます。そのフォルダ内にtest.texというファイルを作って、適当にサンプルコードを書いて実行してみましょう!
例えば...

test.tex
\documentclass{article}
\begin{document}
Hello, LaTeX!
\end{document}

こんな感じ
outputというフォルダ内にtest.pdfがあれば成功です!お疲れ様でした!
保存(⌘+s)すると自動的にビルドされるようにしてあるので左側にエディタ、右側にpdfを置いて保存しながら書いていくと完成形をみながら作れるのでやってみて

8. まとめ

ここまで読んでくれてありがとうございました。無事に環境構築できていたらいいな〜〜〜〜〜と思います。もしうまくいかなかったりよくわからない部分があれば私のツイッターのDMとかdiscordで聞いてください!!

Discussion

Larry MizunoLarry Mizuno

既に、vscode最新版が、Homebrew経由でなく直接ダウンロードで、インストールされていて、mactexは、Homebrewで、
最新版になっている場合、
Error: Cask 'mactex-no-gui' conflicts with 'mactex'.
と返ってきます。

まだ、十分にCLIやPATH, macOSの新しいファイル構造が解ってません。何せMacintoshは、GUIパソコンなんで、コマンドラインを何十年と使ったことがないです。誠にお手数ですが、よろしくお願いいたします。

あなたあなた

エラーの内容を読むとmactexとmaxtex-no-guiが競合しているかと思います.mactexかmactex-no-guiのどちらかをアンインストールしなければならないと思います.mactexとmactex-no-guiのどちらもhomebrewでインストールしているならばbrew uninstall mactexまたはbrew uninstall mactex-no-guiとしてパッケージをアンインストールしてください.(mactexの方をアンストするのをおすすめします)

Larry MizunoLarry Mizuno

ご返信、ありがとうございます。
やってみたら、sudoが必要とのレスポンスがあり、次のような再入力が返ってきました。macOS特有のrootレスのようです。

@iMac ~ % sudo brew uninstall mactex
Password:
Error: Running Homebrew as root is extremely dangerous and no longer supported.
As Homebrew does not drop privileges on installation you would be giving all
build scripts full access to your system.
mizuno******@iMac ~ %

どうしたらいいでしょうか。よろしくお願いします。

Larry MizunoLarry Mizuno

##なに気なしに、つい、2度目同じ事をしてみましたら、出来ました。不思議ですが。
###@iMac ~ % brew uninstall mactex
==> Uninstalling Cask mactex
==> Uninstalling packages with sudo; the password may be necessary:
org.tug.mactex.texlive2025
Password:
==> Removing files:
/Applications/TeX
/etc/manpaths.d/TeX
/etc/paths.d/TeX
/Library/TeX
/usr/local/texlive/2025
==> Purging files for version 2025.0308 of Cask mactex
@iMac ~ %

brew -v
Homebrew 4.5.2-98-g6966797

Larry MizunoLarry Mizuno

どうもインストールできたようですが。

@iMac ~ % lualatex -v
This is LuaHBTeX, Version 1.21.0 (TeX Live 2025)
Development id: 7667

Execute 'luahbtex --credits' for credits and version details.

There is NO warranty. Redistribution of this software is covered by
the terms of the GNU General Public License, version 2 or (at your option)
any later version. For more information about these matters, see the file
named COPYING and the LuaTeX source.

LuaTeX is Copyright 2025 Taco Hoekwater and the LuaTeX Team.

で、
iMac ~ % TeX
This is TeXk, Version 3.141592653 (TeX Live 2025) (preloaded format=TeX)
restricted \write18 enabled.
**
Please type the name of your input file.
**
で、TeXkって、聞いたこともないTeXがあるようで、良いのでしょうか。

あなたあなた

返信が遅れてしまい申し訳ありません.
私もlatexは大学入学後から使い始めたものでまだ全容を把握しきれていないのですが,調べてみたところKnuthのオリジナルTeXの実行ファイルらしく普通のtexエンジンのようです.(私も聞いたことありませんでした....)動作重視の回答で申し訳ないのですが,lualatex {filename}.texまたはlatex {filename}.texでコンパイルができるのであれば問題ないかと思います.ずばりとした回答でなく申し訳ありません.

Larry MizunoLarry Mizuno

ありがとうございます。
出力にあったコマンドを入れたら、次のようになりました。:

@iMac ~ % luahbtex --credits
This is LuaHBTeX, Version 1.21.0 (TeX Live 2025)

The luatex project is a ConTeXt community project by
Hans Hagen, Hartmut Henkel, Taco Hoekwater and Luigi Scarso.
The current maintainers are Hans Hagen and Luigi Scarso.

LuaHBTeX merges and builds upon (parts of) the code from these projects:

tex : Donald Knuth
etex : Peter Breitenlohner, Phil Taylor and friends
omega : John Plaice and Yannis Haralambous
aleph : Giuseppe Bilotta
pdftex : Han The Thanh and friends
kpathsea : Karl Berry, Olaf Weber and others
lua : Roberto Ierusalimschy, Waldemar Celes and Luiz Henrique de Figueiredo
metapost : John Hobby, Taco Hoekwater, Luigi Scarso, Hans Hagen and friends
pplib : Paweł Jackowski
fontforge : George Williams (partial)
luajit : Mike Pall (used in LuajitTeX)

Compiled with libharfbuzz 10.2.0; using 10.2.0
Compiled with libpng 1.6.46; using 1.6.46
Compiled with lua version 5.3.6
Compiled with mplib version 2.11
Compiled with zlib 1.3.1; using 1.3.1

Development id: 7667

Larry MizunoLarry Mizuno

TeXShopで、サンプル文をコピペして、実行させたら、コンパイルして、pdfファイルを出力しました。LaTeXは、インストール出来たようですが、macOSシステムを汚してしまったような印象を持ってしまいました。CLIは、GUIオンリーには、厳しいようです。ぼちぼち、次は、VSCode for Macと、Jedit Ω Proで、TeXファイルのコンパイルで切る環境を作りたいと思います。よろしくお願いします。