用途:该技能用于 LaTeX 文档编译与实时预览,覆盖一次性构建、监视模式自动重建、多文件项目管理、构建失败排查与清理构建产物。
主要能力:基于 latexmk,自动检测依赖(如参考文献、索引等),自动运行正确次数以处理交叉引用;支持 live preview 监视文件变化并自动重新编译,并可配合 Skim 的 SyncTeX 自动重载 PDF。
必要用法:一次性构建使用 latexmk -pdf document.tex;实时预览使用 latexmk -pvc -pdf document.tex,停止监视按 Ctrl+C;启用 SyncTeX 使用 latexmk -pdf -synctex=1 document.tex;清理产物使用 latexmk -c(保留 PDF)或 latexmk -C(连同 PDF 删除);强制重建使用 latexmk -gg -pdf document.tex;CI 非交互使用 latexmk -pdf -interaction=nonstopmode document.tex。
适用场景:编译 LaTeX 文档、设置自动重建的实时预览、管理多文件项目、排查构建失败、清理构建产物以及自动化编译工作流。
限制与排错:若提示 latexmk not found,需将 /Library/TeX/texbin 加入 PATH;出现 Undefined control sequence 需检查所需宏包;参考文献显示 ?? 通常由多次运行处理,latexmk 会自动应对;实时预览不更新需在 Skim 偏好设置中开启 Sync → Check for file changes;构建挂起可加 -interaction=nonstopmode;PDF 未更新应查看 .log 文件;SyncTeX 不工作需添加 -synctex=1。macOS 上 MacTeX 已自带 latexmk,无需单独安装;详细配置与多文件依赖、CI 集成等参考文档暂未提供完整细节。