TeX 环境 / TeX 发行版

概览

TeX64 调用 latexmk、lualatex、latexindent 等命令行工具编译文档。您可使用现有 TeX 发行版，或确认由 TeX64 下载并安装受管理的 TeX Live。

为什么需要 TeX 发行版

TeX64 的应用包不内置 LaTeX 引擎，而是调用设备上现有或由应用管理的 TeX 发行版。没有 TeX 发行版时无法编译。

  • TeX64 依赖外部 TeX 工具（latexmk、lualatex、synctex）
  • 安装 TeX 发行版是前置条件
  • 若未安装发行版，TeX64 会显示编译错误

选择项

MacTeX（推荐）

  • 大小：约 4 GB
  • URL：https://www.tug.org/mactex/
  • 安装：下载 .pkg 并运行安装程序
  • 包含内容：全部（latexmk、lualatex、latexindent、synctex 及全部宏包）
  • 面向日语用户：默认包含 CJK 宏包
  • 适用人群：初学者，希望零配置的用户

BasicTeX（精简安装）

TeX Live（手动）

  • 在 MacTeX 之外直接管理 TeX Live
  • Homebrew 用户：brew install texlive

安装验证

打开终端并运行以下命令以确认所有工具均被找到：

which lualatex
which latexmk
which latexindent
which synctex

都应返回路径。如果有返回为空，则该工具未安装或不在 PATH 中。

在 TeX64 中：设置 > 环境 会显示每个工具的绿/红状态。

Windows 10/11 设置

Windows x64 可使用受管理的 TeX Live、手动安装的 TeX Live 或 MiKTeX。

受管理的 TeX Live

  • 打开 TeX64 > 设置 > 环境，选择安装受管理的 TeX Live。
  • 确认下载。完整 TeX Live 需要数 GB 空间，安装可能耗时较长。
  • 完成前保持 TeX64 打开；安装位于应用管理目录并会自动检测。

TeX Live（手动）

  • 从 TeX Users Group 下载并运行官方 Windows 安装程序。
  • 若有数 GB 可用空间，选择完整方案以减少缺失宏包错误。
  • 将 C:\texlive\<year>\bin\windows 加入 PATH，然后完全退出并重启 TeX64。
  • https://www.tug.org/texlive/acquire-netinstall.html

MiKTeX

  • 安装 MiKTeX，并在 MiKTeX Console 中更新及安装缺失的宏包。
  • 如需在构建时自动解决缺失的 .sty，请启用按需安装。
  • 确认 MiKTeX bin 目录已加入 PATH，且 lualatex、latexmk 和 synctex 可用。
  • https://miktex.org/download

从 PowerShell 验证

在新 PowerShell 窗口运行以下命令，然后检查 TeX64 的设置 > 环境：

Get-Command lualatex
Get-Command latexmk
Get-Command latexindent
Get-Command synctex

若找不到命令，请在 Windows 设置 > 系统 > 关于 > 高级系统设置 > 环境变量修正 PATH，再完全退出并重开 PowerShell 与 TeX64。

Windows 故障排查

  • TeX Live：确认 PATH 中的年份与安装文件夹一致，且以 \bin\windows 结尾。
  • MiKTeX：在 MiKTeX Console 中更新，并安装 latexmk 或构建日志中的缺失宏包。
  • 受管理安装：确保网络稳定且有数 GB 空间，从设置 > 环境重试；联系支持时附上安装/构建日志。

宏包管理（tlmgr）

  • 更新宏包管理器：sudo tlmgr update --self
  • 更新全部宏包：sudo tlmgr update --all
  • 安装宏包：sudo tlmgr install <package>
  • 搜索宏包：sudo tlmgr search --global --file <filename>

PATH 配置

  • MacTeX 会自动添加 /Library/TeX/texbin
  • Homebrew 使用 /opt/homebrew/bin
  • 若未设置 PATH：在 ~/.zshrc 中添加 export PATH="/Library/TeX/texbin:$PATH"
  • 修改 PATH 后请重启终端和 TeX64

日语 LaTeX 配置

  • MacTeX： 默认包含 CJK 宏包
  • BasicTeX： 单独安装日语宏包：sudo tlmgr install collection-langjapanese
  • 在 lualatex 中使用 luatexja 宏包
  • 在 .tex 文件中添加 \usepackage{luatexja}

常见问题

找不到 latexmk

安装 MacTeX 或运行 sudo tlmgr install latexmk

缺少 .sty 文件

运行 sudo tlmgr install <package>

PATH 问题

添加到 shell 配置文件

权限被拒

使用 sudo

如有疑问或需要支持，请访问支持页面。