TeX 环境 / TeX 发行版
概览
TeX64 调用 latexmk、lualatex、latexindent 等命令行工具来编译您的文档。必须在系统上预先安装 TeX 发行版。
为什么需要 TeX 发行版
TeX64 不自带 LaTeX 引擎，而是调用 Mac 上的系统命令。没有 TeX 发行版就无法编译。
- TeX64 依赖外部 TeX 工具（latexmk、lualatex、synctex）
- 安装 TeX 发行版是前置条件
- 若未安装发行版，TeX64 会显示编译错误
选择项
MacTeX（推荐）
- 大小：约 4 GB
- URL：https://www.tug.org/mactex/
- 安装：下载 .pkg 并运行安装程序
- 包含内容：全部（latexmk、lualatex、latexindent、synctex 及全部宏包）
- 面向日语用户：默认包含 CJK 宏包
- 适用人群：初学者，希望零配置的用户
BasicTeX（精简安装）
- 大小：约 100 MB
- URL：https://www.tug.org/mactex/morepackages.html
- 安装后：使用 tlmgr 手动添加缺少的宏包
- 适用人群：希望节省磁盘的有经验用户
TeX Live（手动）
- 在 MacTeX 之外直接管理 TeX Live
- Homebrew 用户：brew install texlive
安装验证
打开终端并运行以下命令以确认所有工具均被找到：
which lualatex which latexmk which latexindent which synctex
都应返回路径。如果有返回为空，则该工具未安装或不在 PATH 中。
在 TeX64 中：设置 > 环境 会显示每个工具的绿/红状态。
宏包管理（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
如有疑问或需要支持，请访问支持页面。