PAYATHON 2026

如何防止 Quarto 每次渲染都在项目目录生成 .quarto_ipynb 文件?

数据小许

结论

可以在项目的 post-render hook 中调用 PowerShell,在渲染结束后删除匹配的 .quarto_ipynb 文件。这个方法负责渲染后的清理,执行过程中仍会创建文件。

根据题目提供的信息,无法确认 Quarto 1.9.36 是否有直接禁止生成 .quarto_ipynb 文件的配置。在题述环境中,keep-ipynb: false 没有解决这个问题,因此不能将它视为禁止生成这些文件的开关。

为什么设置 keep-ipynb: false 后仍有文件

最终 .ipynb 文件的保留设置和执行过程中产生的中间文件需要分别处理。题述环境中,调整 keep-ipynb 后,项目目录里仍有 .quarto_ipynb 文件,可以在渲染结束后清理。

仅凭这些现象,无法确定文件残留是否与该版本或 Positron 的具体渲染流程有关。

配置渲染后自动清理

在 Quarto 实际读取的项目配置文件中,将 post-render 放在 project 下。如果已有 project 配置,请将下面的内容合并进去,避免重复定义同名键。

project:
  post-render:
    - >-
      powershell -NoProfile -Command "Get-ChildItem -LiteralPath . -File -Filter '*.quarto_ipynb' | Remove-Item -Force"

这里使用 YAML 折叠块,减少引号转义。命令中各部分的作用如下:

  • -LiteralPath .:搜索 hook 的当前工作目录;项目 hook 应在项目根目录运行,首次使用时应核对实际路径。
  • -File:只匹配文件。
  • -Filter '*.quarto_ipynb':只选择名称符合该模式的文件。
  • Remove-Item -Force:删除匹配项。

题目中的文件出现在项目根目录,所以示例没有使用 -Recurse。如果子目录中也有需要清理的同类文件,可以加入该参数:

project:
  post-render:
    - >-
      powershell -NoProfile -Command "Get-ChildItem -LiteralPath . -Recurse -File -Filter '*.quarto_ipynb' | Remove-Item -Force"

-Recurse 会将清理范围扩大到子目录,可能同时删除其他文档渲染后留下的匹配文件。

先核对匹配范围

首次配置前,可以在项目根目录打开 PowerShell,先列出文件路径:

Get-ChildItem -LiteralPath . -File -Filter '*.quarto_ipynb' |
    Select-Object -ExpandProperty FullName

确认列出的都是需要清理的文件后,再启用删除命令。如果准备递归清理,检查时也应加入 -Recurse。

原命令中的 -ErrorAction SilentlyContinue 会隐藏删除失败的信息。初次排查时建议先省略它,以便看到权限不足、文件占用等错误。

使用时的注意事项

需要确认从 Positron 发起的渲染实际加载了项目配置,并执行了 post-render hook。加入配置后,应完成一次渲染,检查文件是否已清理。

post-render 无法处理所有中断情况。渲染失败、被取消,或者 hook 没有执行时,仍可能留下文件。也应避免在同一项目的其他渲染任务运行期间,清理其可能正在使用的中间文件。

备注:内容仅供参考。