LaTeX 参考下载 TeX64

桌面安装

本页介绍了在您自己的计算机上安装 TeX、OS by OS 的具体步骤：Windows、macOS，然后是 Linux/Unix。选择哪个发行版已在其他地方介绍过——这里我们重点关注实际启动安装程序，将二进制文件放在您的 PATH 上，并确认落地的内容。当前版本是 TeX Live 2026（2026 年 3 月 1 日发布）及其 macOS 版本 MacTeX-2026。

开始之前

安装本质上是在两种尺寸之间进行选择。 完整安装（默认 scheme-full）约为 7 GB，并将每个包和字体捆绑在 CTAN 上；如果您有磁盘和带宽，从长远来看，这是最不麻烦的，因为您永远不会去寻找丢失的软件包。 最小安装（BasicTeX 或 scheme-basic）只有几百个 MB，但是您可以使用 tlmgr 添加稍后缺少的内容。在连接速度较慢的情况下，完整安装可能需要一个小时或更长时间才能下载和解压。

每个发行版 (TeX Live / MiKTeX / MacTeX) 的实际含义以及它们的比较方式都位于“发行版”页面上。之后添加包 (tlmgr) 和 TEXMF 树的布局也都有自己的页面。本页重点关注安装过程本身。

安装在 Windows 上

在 Windows 上，您有两个主要选项。 TeX Live 是跨平台标准，每年发布一次跨操作系统的版本。 MiKTeX 诞生于 Windows，并以在命令需要时动态获取丢失的包而闻名。两者都可以；以下是两者的步骤。

对于 TeX Live。 从 tug.org 下载 install-tl-windows.exe （大约 20 个 MB；相同的 install-tl.zip 也可以）并运行它。它是一个网络安装程序：一旦启动，它就会在安装时从 CTAN 镜像中提取整个发行版。默认位置是C:\texlive\2026，方案（安装多少）和目标文件夹在GUI中选择。在 Windows 上安装程序会为您设置 PATH，因此当安装完成后，您只需打开一个新的命令提示符即可运行（如果 PATH 上已存在另一个 TeX，则新的将被添加到前面；否则将被附加）。

terminal
REM Verify the install in a new Command Prompt (cmd.exe)
tex --version
where pdflatex
where tlmgr

对于 MiKTeX。 从 miktex.org 的下载页面获取 基本 MiKTeX 安装程序 (.exe) 并运行它。 建议按用户安装，不需要管理员权限。在安装过程中，您可以选择是否自动安装缺少的软件包 - “首先询问我”、“始终”或“从不”。 完成后，惯例是启动 MiKTeX Console 并首先检查更新。对于在许多机器上进行无人值守的部署，还可以通过 miktexsetup 进行可编写脚本的命令行安装。

安装在 macOS 上

macOS 的标准是 MacTeX：为 Mac 打包的整个 TeX Live，加上 GUI 应用程序（TeXShop、BibDesk、LaTeXiT、TeX Live Utility）和 Ghostscript。从tug.org下载MacTeX.pkg（大约6.4 GB），双击它，然后按照提示操作。发行版本身进入 /usr/local/texlive/2026。 MacTeX-2026 需要 macOS 11（Big Sur，2020）或更高版本，并在 Intel 和 Apple Silicon 上运行； Catalina 及更早版本不再受支持。

macOS对PATH考虑周到。 MacTeX 不是将二进制文件夹本身（例如 /usr/local/texlive/2026/bin/universal-darwin）放在 PATH 上，而是维护一个 符号链接 /Library/TeX/texbin，它指向活动发行版的二进制文件。放入 /etc/paths.d 的文件然后将 /Library/TeX/texbin 添加到默认的 PATH。所以新打开的终端就可以工作，并且在已安装的版本之间切换会自动更新 PATH。要立即在已打开的 shell 中使用它，请运行：

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

如果您不需要 GUI 应用程序并且命令行就足够了，Homebrew 是快速路线。 mactex 包括 GUI 应用程序； mactex-no-gui 与没有它们的完整 TeX Live 相同； basictex 是一个更小的最小构建（没有 GUI，没有 Ghostscript），安装到 /usr/local/texlive/2026basic 中。

terminal
# Full TeX Live without the GUI apps (most common via Homebrew)
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上有两条路径，选择会影响你以后的舒适度。一种是 来自 tug.org 的官方安装程序 install-tl；另一个是您的发行版的软件包（Debian/Ubuntu 上的 texlive-full、Fedora 上的 texlive-scheme-full 等）。

首先，官方安装程序。它的优点是您可以在发布当天获得最新版本，并且可以随时使用 tlmgr 更新各个软件包。获取 install-tl-unx.tar.gz，解压它，然后运行捆绑的 Perl 脚本。默认位置是 /usr/local/texlive/2026。如果您更愿意 使用 GUI 而不是文本界面，perl ./install-tl -gui 会启动 Tcl/Tk 版本（Mac 上的标准版本，并且可以轻松添加到大多数 Linux 发行版上）。

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-*

# Interactive text installer (use sudo if installing under /usr/local)
sudo perl ./install-tl

# ...or a non-interactive default install:
# sudo perl ./install-tl --no-interaction

在 Unix 上您自己设置 PATH（与 Windows 不同，它不会自动完成）。二进制目录以您的 CPU 命名 — 在 64 位 Intel/AMD 上，它是 /usr/local/texlive/2026/bin/x86_64-linux。您不必记住 CPU 名称：安装程序打印要在运行结束时添加的确切行。将它们放入 shell 启动文件中（现代 macOS 上为 ~/.zshrc，其中 zsh 是默认值；bash 系列 shell 为 ~/.profile 或 ~/.bashrc）。

terminal
# Add to ~/.profile or ~/.bashrc (adjust the platform folder for your CPU)
export PATH="/usr/local/texlive/2026/bin/x86_64-linux:$PATH"

# Then reload and verify
source ~/.profile
tex --version

相比之下，分发包（sudo apt install texlive-full 等）会融入系统并为您解决依赖关系。但请注意两件事。首先，它是 巨大 — texlive-full 运行到几个 GB。其次，更新的时间和内容取决于您的 OS 供应商，因此它可能会滞后官方每年的发布数月甚至数年。如果您需要最新的软件包或每个软件包的 tlmgr 更新，请首选官方安装程序。两者可以作为独立的树共存； PATH 上第一个出现的就是您使用的那个。

验证安装和您的 PATH

在每个 OS 上，安装后，打开一个新终端并检查它是否正常工作。如果 tex --version 打印版本（例如 TeX Live 2026），则找到二进制文件。接下来，确认实际运行的可执行文件所在的位置。

terminal
# macOS / Linux
which pdflatex      # prints the path that will run, e.g. /Library/TeX/texbin/pdflatex

# Windows (cmd.exe)
where pdflatex      # prints C:\texlive\2026\bin\windows\pdflatex.exe

如果 which/where 不返回任何内容，或者指向意外的地方，则这是一个 PATH 问题。检查显示的路径是否指向旧版本或不同的发行版。当存在多个 TeX 安装时，运行的安装是以 PATH 上第一个安装的为准。为了确保选择您想要的版本，请将其二进制目录放在启动文件中 PATH 的前面 - 进行任何更改后，打开新终端或重新加载启动文件。

常见的陷阱是在尝试修复 PATH 时混合分布。如果 pdflatex 来自 TeX Live，bibtex 来自 OS 包，tlmgr 来自较旧的 MacTeX，那么当您认为它们正在处理一份手稿时，它们正在查看不同的树。检查 which pdflatex、which lualatex 和 which tlmgr（或 Windows 上的 where）并确认它们指向相同的年度版本和分发。

  • 在已经安装了 TeX 的机器上安装之前，记录当前 pdflatex 所在的位置。
  • 如果您使用上游 TeX Live，请避免稍后为同一工作流程添加 OS texlive-* 包。
  • 如果您使用 MiKTeX，请将更新和软件包添加内容保留在 MiKTeX Console 内。

最后证明它确实可以排版。创建一个小.tex，编译它，如果出现PDF，则安装完成。

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

阅读下一篇