Documenter.jl构建卡在ExpandTemplates步骤是什么原因导致的?
Documenter.jl 构建卡在
ExpandTemplates步骤的可能诱因 - 新增/修改的Markdown文档存在递归引用:如果文档中使用了
!include嵌套包含语句、@ref跨文档引用,出现了循环包含(A文档包含B,B文档又包含A),或者引用了不存在的锚点,会导致Documenter在模板展开阶段反复检索定位,陷入死循环。 - 文档目录误纳入大体积/二进制文件:如果本次拉取的更新将大型图片、数据集、可执行文件等非文档内容放到了
docs/src目录下,模板展开步骤会遍历目录下所有文件,碰到无法解析的大文件时会无响应卡顿。 - 内嵌文档测试代码死循环:虽然构建日志显示Doctest阶段已完成,但部分写在Markdown文件内的
jldoctest代码块如果包含死循环逻辑,或者依赖的项目接口更新后运行无返回,会在模板展开执行内嵌代码时卡住。 - 文档环境依赖版本冲突:拉取的代码虽然没有修改Documenter相关配置,但可能更新了项目本身的依赖版本,和本地文档环境中安装的Documenter、或者Documenter依赖的Markdown解析、代码执行相关包出现兼容性问题,导致解析流程阻塞。
- 目录存在循环软链接:如果本次更新给docs目录添加了指向上级目录的软链接,模板展开时的目录遍历会进入死循环,持续扫描重复路径无法退出。
内容的提问来源于stack exchange,提问作者joinijo
相关产品推荐
相关产品推荐

