Menu
Eleventy
1.93s
Next.js
70.65s
调试模式
Contents
遇到麻烦了吗?是否想看看 Eleventy 在幕后到底做了什么? DEBUG
模式可以帮你解惑。这一功能是基于 出色的 debug
软件包 实现的。
debug
能够明确地告诉你 data、includes、input 和 output 各自对应的是哪个目录,它还能告诉你查找模板时用的是什么 glob(类似正则表达式的东西),以及找到了哪些模板。如果你遇到了问题,请开启此功能。
通过环境变量(Environment variables)可以开启此功能,准确地说是 DEBUG
环境变量。实际使用时,在运行 Eleventy 的命令前添加一些设置环境变量的字符串即可。
命令 Jump to heading
Mac OS (或 Linux 等) Jump to heading
本地安装和 全局安装 有什么区别?
全局安装
DEBUG=Eleventy* eleventy
本地安装
DEBUG=Eleventy* npx @11ty/eleventy
Windows Jump to heading
阅读有关 Windows 环境变量 的更多信息。
cmd.exe Jump to heading
本地安装和 全局安装有什么区别?
本地安装
set DEBUG=Eleventy* & npx @11ty/eleventy
全局安装
set DEBUG=Eleventy* & eleventy
Powershell (VS Code 默认) Jump to heading
本地安装和 全局安装有什么区别?
本地安装
$env:DEBUG="Eleventy*"; npx @11ty/eleventy
全局安装
$env:DEBUG="Eleventy*"; eleventy
了解更多 Jump to heading
请参阅 debug
软件包的文档 以了解更多信息。
--dryrun
参数
Jump to heading
如果你想运行 Eleventy 但不希望输出到文件系统的话,请添加 --dryrun
参数。
查看所有信息 Jump to heading
前述命令通过设置 DEBUG=Eleventy*
将来自 debug
的消息限定为 Eleventy 相关的信息,但是你可以通过设置 DEBUG=*
查看来自所有依赖包输出的所有信息。
分析性能 Jump to heading
阅读有关如何 使用 debug
来分析 Eleventy 构建性能 的更多信息。
调试单个变量 Jump to heading
除了使用 debug
外,你还可以在模板中使用全局过滤器(filter) log
输出任何内容,就像 console.log
一样。