迁移到 Pug 3

如果你要从 Jade 迁移，请先按照迁移到 Pug 2 文章进行操作。本文介绍如何从 Pug 2 升级到 Pug 3。

有关新功能的完整列表，请参阅发行说明。以下是仅处理重大变更的说明。

带有minify 的过滤器¶

如果你使用输出 JavaScript 或 CSS 的过滤器以及 minify 选项，则现在需要包含额外的依赖。如果你想支持缩小 JavaScript，你必须安装 jstransformer-uglify-js，如果你想支持缩小 CSS，你必须安装 jstransformer-clean-css。

read插件现在应该返回Buffer¶

如果你使用read 插件来覆盖 pug 读取文件的方式，并且想要支持新的 renderBuffer过滤器，则需要返回Buffer。

例如

//- oldpug.renderFile(filename, { plugins: [ { read: (filename)=>{// this returns a"string"returnfs.readFileSync(filename,'utf8'); }, } ]})

//- newpug.renderFile(filename, { plugins: [ { read: (filename)=>{// this returns a"Buffer"returnfs.readFileSync(filename); }, } ]})

Node.js 支持¶

我们放弃了对 10.0.0 之前的节点版本的支持。我们建议将所有使用 pug 的项目升级到 node.js 12，但我们将在 2021 年 4 月之前支持 10。

将来，我们可能会放弃对节点版本当他们到达生命的尽头时的支持，而无需进行主要版本升级。