LaTeX 레퍼런스TeX64란

데스크톱 설치

LaTeX 설치가 끝나고 사람들이 가장 먼저 치는 확인 명령은 대개 pdflatex --version입니다. 그런데 돌아오는 것은 “pdfLaTeX”가 아니라 pdfTeX 3.141592653-2.6-1.40.26 (TeX Live 2024) 입니다. 버전 번호가 원주율인 것은 농담이 아니라 커누스가 TeX의 판 번호를 π로 수렴시키기로 정했기 때문이고, pdflatex가 pdfTeX라고 밝히는 까닭은 pdflatex 자체가 pdftex로 가는 심볼릭 링크이기 때문입니다. 이 페이지에서는 Windows・macOS・Linux 각각의 설치 절차를 따라가며 실제로 무엇이 들어왔는지 확인하고, 이어서 누구나 걸려 넘어지는 문제, 곧 명령이 PATH에 잡히지 않는 상황을 제대로 정리합니다. 현재 판은 TeX Live 2026(2026년 3월 1일 공개)과 MacTeX-2026입니다.

설치 프로그램을 띄우기 전에 정할 두 가지

정할 것은 얼마나 넣을지(스킴) 와 어디에 넣을지 둘뿐이고, 나머지는 설치 프로그램이 물어봅니다. 기본값 scheme-full은 8 GB 안팎, 중간인 scheme-medium은 2 GB 남짓, 최소급인 scheme-basic은 200 MB를 조금 넘습니다. 회선이 가늘면 전체 설치의 내려받기와 풀기에 한 시간 넘게 걸리는 일도 드물지 않습니다. 어느 스킴이 어디까지 담는지, 애초에 TeX Live와 MiKTeX 중 무엇을 넣을지는 “배포판” 페이지에서 비교했으니, 여기서는 정한 뒤의 작업에 집중합니다.

Windows에 LaTeX 설치하기

Windows는 세 플랫폼 가운데 손이 가장 덜 가는 쪽입니다. TeX Live라면 tug.org에서 install-tl-windows.exe(약 20 MB, 내용이 같은 install-tl.zip도 무방)를 받아 실행하면 됩니다. 넷 설치 프로그램이라 실행한 뒤 CTAN 미러에서 본체를 내려받으며 설치합니다. 기본 설치 위치는 C:\texlive\2026이고 스킴은 GUI에서 고릅니다. 중요한 점은 Windows에서는 설치 프로그램이 PATH를 알아서 설정해 준다는 것입니다(다른 TeX이 이미 PATH에 있으면 앞에, 없으면 뒤에 붙입니다). 끝나면 명령 프롬프트를 새로 열어 주십시오. 계속 열려 있던 창은 여전히 옛 PATH를 쥐고 있습니다.

terminal
REM Verify in a NEW Command Prompt after the installer finishes
where pdflatex
pdflatex --version
tlmgr --version

MiKTeX를 고른다면 miktex.org의 다운로드 페이지에서 Basic MiKTeX Installer(.exe)를 받아 실행합니다. 마법사가 묻는 것은 사실상 셋입니다. 현재 사용자만(권장)인지 모든 사용자 공유인지, 용지 크기, 그리고 없는 패키지를 자동으로 설치할지(Always / Ask me first / Never) 입니다. 공유 설치는 관리자 권한이 필요하고, 자동으로 받아 온 패키지는 어차피 사용자별 트리에 떨어지므로 개인 PC라면 “현재 사용자만”이 솔직한 선택입니다. 끝난 뒤에는 MiKTeX Console을 띄워 Updates부터 확인하는 것이 정석입니다. 연구실의 수십 대에 무인으로 배포하려면 miktexsetup를 쓴 무인 설치가 마련되어 있습니다.

macOS에 LaTeX 설치하기(MacTeX)

macOS의 표준은 MacTeX입니다. tug.org에서 MacTeX.pkg(약 6.4 GB)를 받아 더블클릭하고 안내를 따르면 됩니다. Apple의 서명·공증을 받았으므로 Gatekeeper가 막지 않습니다. TeX 본체는 /usr/local/texlive/2026에 들어가고, GUI 앱(TeXShop, BibDesk, LaTeXiT, TeX Live Utility)은 /Applications/TeX/에 놓입니다. MacTeX-2026은 macOS 11(Big Sur) 이상을 요구하며 Intel과 Apple 실리콘 모두에서 네이티브로 동작합니다(Catalina 이전은 지원하지 않습니다).

PATH에 관해서는 macOS가 셋 중 가장 세심합니다. MacTeX은 바이너리 디렉터리(/usr/local/texlive/2026/bin/universal-darwin)를 PATH에 직접 넣는 대신, /Library/TeX/texbin이라는 고정된 심볼릭 링크를 현재 유효한 판의 바이너리로 향하게 합니다. 이 Mac에서 따라가 보면 /Library/TeX/texbin → Distributions/Programs/texbin → 현재 연도판의 bin이라는 사슬이고, /etc/paths.d에 놓인 파일이 /Library/TeX/texbin을 기본 PATH에 더합니다. 덕분에 새 터미널을 열면 그대로 쓸 수 있고, 내년 판으로 갈아타도 설정 파일을 고칠 필요가 없습니다. 이미 열려 있는 셸에서 바로 쓰고 싶다면 path_helper를 불러 PATH를 다시 만듭니다.

terminal
# Refresh PATH in the current shell, then verify
eval "$(/usr/libexec/path_helper)"
which pdflatex      # -> /Library/TeX/texbin/pdflatex
pdflatex --version

GUI 앱이 필요 없고 명령줄만으로 충분하다면 Homebrew가 빠른 길입니다. mactex는 GUI 앱을 포함하고, mactex-no-gui는 같은 전체 TeX Live에서 그것들을 뺀 것이며, basictex는 훨씬 작은 최소 구성(GUI도 Ghostscript도 없음)으로 /usr/local/texlive/2026basic에 설치됩니다. 어차피 대부분 VS Code 같은 편집기를 쓰므로 실무에서는 mactex-no-gui가 자주 선택됩니다.

terminal
# Full TeX Live without the GUI apps (the usual Homebrew choice)
brew install --cask mactex-no-gui

# Or the full bundle with GUI apps
# brew install --cask mactex

# Or a small starter install
# brew install --cask basictex

Linux / Unix에 설치하기

Linux/Unix에서는 공식 설치 프로그램 install-tl을 쓰는 것이 순리입니다. install-tl-unx.tar.gz를 받아 풀고 함께 들어 있는 Perl 스크립트를 실행합니다. 기본 설치 위치는 /usr/local/texlive/2026이고, 그곳에 쓰려면 sudo가 필요합니다. sudo를 쓰고 싶지 않다면 대화식 메뉴에서 D(directories)를 눌러 설치 위치를 ~/texlive/2026처럼 홈 아래로 옮기면 권한 문제가 사라집니다. 텍스트 화면보다 GUI로 진행하고 싶다면 perl ./install-tl -gui가 Tcl/Tk 판을 띄우고, 전부 맡겨도 된다면 --no-interaction으로 아무것도 묻지 않고 기본 구성이 설치됩니다.

terminal
# Download, unpack and run the official net installer
cd /tmp
curl -LO https://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz
zcat < install-tl-unx.tar.gz | tar xf -
cd install-tl-*

sudo perl ./install-tl                 # interactive text installer
# sudo perl ./install-tl -gui          # Tcl/Tk installer instead
# sudo perl ./install-tl --scheme scheme-medium --no-interaction

Unix에서는 PATH를 직접 설정합니다. Windows와 달리 자동으로 되는 단계가 없습니다. 바이너리 디렉터리 이름은 CPU에 따라 달라져서, 64비트 Intel/AMD면 /usr/local/texlive/2026/bin/x86_64-linux이고, 이 기기처럼 macOS면 universal-darwin입니다. 이름을 외울 필요는 없습니다. 설치 프로그램이 끝나기 직전에 추가해야 할 줄을 그대로 찍어 줍니다. man 페이지와 info 페이지 경로도 함께 나오니 세 줄을 통째로 셸 시작 파일(zsh면 ~/.zshrc, bash 계열이면 ~/.profile이나 ~/.bashrc)에 옮겨 적으십시오.

terminal
# Add to ~/.profile or ~/.bashrc; the folder name follows your CPU
export PATH="/usr/local/texlive/2026/bin/x86_64-linux:$PATH"
export MANPATH="/usr/local/texlive/2026/texmf-dist/doc/man:$MANPATH"
export INFOPATH="/usr/local/texlive/2026/texmf-dist/doc/info:$INFOPATH"

# Then reload and check
. ~/.profile
which pdflatex

네트워크를 통한 설치가 현실적이지 않을 때, 이를테면 회선이 가늘거나 연구실의 수십 대에 배포해야 하거나 아예 인터넷이 없을 때는 연간 ISO 이미지로 설치할 수 있습니다. CTAN 미러에서 약 6 GB짜리 ISO를 받아 마운트하고 그 안의 install-tl(Windows라면 install-tl-windows.bat)을 실행하면 네트워크 없이 전부 들어갑니다. 다만 ISO의 내용은 공개 후 갱신되지 않으므로, 설치를 마치면 갱신 원본을 온라인 tlnet 저장소로 되돌려 두는 것을 잊지 마십시오.

terminal
# Offline install from the yearly ISO image (Linux/Unix)
sudo mount -t iso9660 -o ro,loop,noauto texlive.iso /mnt
cd /mnt && sudo perl install-tl

# Afterwards, send updates back to the online repository
tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet

제대로 들어왔는지 확인: which pdflatex과 pdflatex --version

확인은 세 단계로, 어느 것이 불리는가, 몇 년 판인가, 어느 트리에 속하는가를 차례로 짚습니다. which pdflatex(Windows에서는 where pdflatex)가 실제로 실행될 파일의 위치를 알려 주고, pdflatex --version은 pdfTeX 3.141592653-2.6-1.40.26 (TeX Live 2024)처럼 연도판까지 포함해 자기를 밝힙니다. 다만 실행 파일의 위치만으로는 부족합니다. 결정타는 kpsewhich -var-value=SELFAUTOPARENT로, 그 실행 파일이 실제로 쓰는 TeX 트리의 뿌리를 돌려줍니다. 이 Mac에서는 /usr/local/texlive/2024가 나옵니다. 바이너리와 참조 트리가 어긋난 환경이라면 이 한 줄이 가장 먼저 거짓을 드러냅니다.

terminal
# 1. which binary runs, 2. which release it is, 3. which tree it uses
which pdflatex
pdflatex --version
kpsewhich -var-value=SELFAUTOPARENT

# On Windows, replace the first line with:
# where pdflatex

마지막으로 정말 조판이 되는지 한 번만 시험합니다. 작은 .tex를 만들어 컴파일하고 PDF가 나오면 설치는 끝난 것입니다. 이 단계에서 오류가 난다면 원인은 거의 PATH가 아닙니다. 작업 디렉터리에 쓸 수 있는지, 파일 이름에 ASCII 밖의 문자가 섞이지 않았는지를 보십시오.

terminal
printf '\\documentclass{article}\\begin{document}Hello, \\LaTeX!\\end{document}' > hello.tex
pdflatex hello.tex
# -> produces hello.pdf

latex 명령을 찾지 못하거나 엉뚱한 연도판이 돌 때

which나 where가 아무것도 돌려주지 않으면 PATH가 잡히지 않은 것입니다. 무언가를 돌려주는데 동작이 이상하다면 찍혀 나온 경로를 찬찬히 보십시오. 흔히 “LaTeX 경로가 안 잡힌다”고 표현되는 증상은 실제로 셋 중 하나입니다. 첫째, 터미널을 다시 열지 않았습니다. 설정은 바꿨지만 그 셸은 여전히 옛 PATH를 쥐고 있습니다. 둘째, PATH가 아직 옛 연도판 트리를 가리킵니다. 작년에 ~/.zshrc에 /usr/local/texlive/2025/bin/...이라 적었고, 올해 판을 설치했는데 그 줄이 그대로 남아 있는 경우가 전형입니다. /usr/local/texlive/2025를 지운 뒤라면 command not found가 뜨고, 지우지 않았다면 작년 판이 조용히 계속 돕니다. 셋째, 두 TeX이 동거하며 앞자리를 다투는 상태입니다.

셋째가 가장 성가십니다. pdflatex은 TeX Live, bibtex은 OS 패키지판, tlmgr은 오래된 MacTeX인 상태가 실제로 벌어집니다. 본인은 원고 하나를 처리한다고 여기지만 도구들은 저마다 다른 나무를 보고 있는 셈이지요. which를 여러 번 치는 대신 tlmgr conf를 한 번 치는 편이 확실합니다. 이 명령은 PATH를 훑어 pdftex, xetex, luatex, dvips, dvipdfmx, kpsewhich, fmtutil, updmap, tlmgr이 각각 해석된 위치를 나열하고, 이어서 현재 유효한 설정 파일과 글꼴 맵 파일의 위치까지 찍어 줍니다. 한 줄이라도 나머지와 다른 트리를 가리킨다면 원인은 거기에 있습니다.

terminal
# One command that resolves every core tool at once
tlmgr conf

# Look for a line whose path differs from the others, e.g.
#   pdftex:    /usr/local/texlive/2026/bin/universal-darwin/pdftex
#   bibtex:    /usr/bin/bibtex          <- a different install!

# The manual equivalent, if tlmgr itself is the thing you distrust
which pdflatex
which lualatex
which tlmgr
  • 시작 파일을 고쳤다면 반드시 터미널을 새로 열거나 파일을 다시 읽어 들이십시오. 계속 열어 둔 터미널은 여전히 옛 PATH입니다.
  • 이미 TeX이 있는 컴퓨터에 설치하기 전에 which pdflatex의 결과를 적어 두십시오. 나중에 무엇이 바뀌었는지 알 수 있습니다.
  • 같은 디렉터리가 PATH에 두 번 나와도 해롭지 않습니다. 해로운 것은 다른 트리를 가리키는 줄이 앞자리를 차지한 경우입니다.
  • 공식 TeX Live를 쓴다면 나중에 apt의 texlive-*를 덧붙이지 마십시오. 트리가 둘이 되어 PATH 앞자리를 다투게 됩니다.
  • MiKTeX를 쓴다면 갱신도 패키지 추가도 MiKTeX Console 안에서 하십시오. tlmgr는 MiKTeX를 관리하지 않습니다.

다음으로 읽기