如何防止 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 没有执行时,仍可能留下文件。也应避免在同一项目的其他渲染任务运行期间,清理其可能正在使用的中间文件。
备注:内容仅供参考。
