我之前在老版本MacOS上用PyLaTeX搭配latexmk时也碰到过类似的循环问题，结合踩过的坑，给你几个可行的解决思路：

1. 给PyLaTeX指定正确的latexmk编译参数 #

默认情况下PyLaTeX可能没给latexmk设置合适的终止条件，导致它反复编译。你可以在创建Document对象时手动指定编译器和参数，强制它完成编译后停止：

from pylatex import Document, Section

# 明确指定用latexmk，并添加防止循环的参数
doc = Document(compiler='latexmk', compiler_args=['-pdf', '-halt-on-error', '-no-shell-escape'])
with doc.create(Section('测试内容')):
    doc.append('先试试极简代码是否能正常运行')

doc.generate_pdf('test_doc', clean_tex=False)

这里的-halt-on-error会让编译器在遇到错误时直接停止，避免无限循环；-pdf指定直接生成PDF文件。

2. 清理残留的LaTeX辅助文件 #

旧的辅助文件（比如.aux、.fls、.fdb_latexmk）很可能干扰latexmk的判断逻辑，导致它误以为需要反复编译。你可以进入项目目录，用终端命令删掉这些文件：

rm -f *.aux *.log *.fls *.fdb_latexmk *.out

删完之后再重新运行你的PyLaTeX代码，大概率能解决循环问题。

3. 检查MacTeX和latexmk的版本兼容性 #

MacOS High Sierra属于比较老的系统，如果你装的MacTeX版本太新，可能和系统不兼容；反过来如果版本太旧，latexmk的逻辑也可能有bug。你可以先检查latexmk的版本：

latexmk --version

如果版本低于4.50，建议用tlmgr更新一下：

sudo tlmgr update --self --all

要是更新时提示系统版本不支持，那你可能需要卸载当前的MacTeX，重新安装适配High Sierra的版本（比如MacTeX 2019，2020及以后的版本不再支持High Sierra）。

4. 用极简代码排查问题 #

你当前的代码导入了很多模块（TikZ、Matrix这些），有可能是某个特定元素（比如带交叉引用的内容、复杂的绘图）触发了循环。可以先写一段极简代码测试，像我上面给的例子那样，如果极简代码能正常运行，再逐步添加你原来的元素，找到具体是哪个部分导致的问题，再针对性调整。

内容的提问来源于stack exchange，提问作者Itachi