用途:面向 macOS 用户的 LaTeX 环境搭建技能,适用于在新机器安装 LaTeX、配置 MacTeX 发行版、配置带 SyncTeX 的 Skim PDF 阅读器、验证安装以及排查缺失宏包。
推荐组件:MacTeX 2025(完整 LaTeX 发行版,即 TeX Live 2025,推荐);Skim 1.7.11(支持 SyncTeX 的 PDF 阅读器,仅 macOS);TeXShop 5.57(可选的原生 macOS LaTeX IDE)。
主要能力与用法:通过 Homebrew 安装,命令为 brew install --cask mactex(约 4.5 GB,包含全部内容)。安装后用 tex --version(预期显示 TeX Live 2025)、pdflatex --version、latexmk --version 验证;可创建 test.tex 测试编译,用 pdflatex test.tex 并确认生成 test.pdf。安装后清单包括:确认版本、编译生成 PDF、若使用 mactex-no-gui 则安装 Skim、用 -synctex=1 测试 SyncTeX、配置 Skim 编辑器集成偏好、必要时将 /Library/TeX/texbin 加入 PATH,以及用 sudo tlmgr install <package> 测试宏包安装。包管理使用 tlmgr 进行查看、安装和搜索。
限制与排查:若提示 tex command not found,需在 shell 配置中加入 /Library/TeX/texbin 到 PATH;tlmgr 权限不足时需用 sudo;找不到宏包可用 tlmgr search 查正确名称;Skim 不显示 PDF 通常是未启用 SyncTeX,需以 -synctex=1 编译;版本过旧可运行 sudo tlmgr update --self --all;编译卡住多为文档死循环或缺少 \end{};磁盘空间不足时可考虑体积更小的 BasicTeX。该技能为自进化型,仅针对真实可复现的问题更新;与其他技能配合:latexmk 自动化见 latex/build,表格见 latex/tables。具体要求与最新细节以官方文档为准。