Jade配置的核心在于理解其基于缩进的语法和编译选项，对于大多数开发者来说，只需掌握基础设置就能在Node.js项目中快速启用模板引擎。
Jade配置环境搭建步骤详解
搭建Jade运行环境是进入模板开发的第一步，虽然Jade官方已停止维护并更名为Pug，但大量遗留项目和国内教程仍沿用Jade术语,因此了解其配置方法依然实用。
确定Node.js版本要求
Jade官方支持Node.js 0.10及以上版本，但推荐使用Node.js 8.x或更高版本以获得更好的稳定性和性能,你可以通过以下命令检查当前Node版本：
node -v
如果版本过低，建议先升级Node.js，多数现代开发环境已内置较新版本,无需额外操作。
通过npm安装Jade或Pug
安装Jade的命令非常直接：
npm install jade --save
该命令会将Jade添加至项目依赖，如果你希望使用继承者Pug,可以执行：
npm install pug --save
两者配置语法高度相似，但Pug修复了部分旧版问题，且仍在更新，新手建议直接使用Pug,但配置参数和迁移成本几乎为零。
验证安装是否成功
在项目根目录创建一个测试文件test.jade,写入以下内容：
html
headJade测试
body
p 你好，Jade!然后运行命令：
node -e "console.log(require('jade').renderFile('test.jade'))"
如果输出一段HTML字符串，说明配置成功，若遇到错误,请检查文件路径和缩进是否正确。
Jade配置核心参数详解
Jade的编译选项丰富，合理配置能极大提升开发体验和输出质量,下面逐一拆解最常用的几个参数。
pretty：美化输出
默认情况下，Jade编译出的HTML为一行紧凑格式，难以阅读，开启pretty选项后,会生成带缩进的可读HTML。
var jade = require('jade');
var html = jade.renderFile('template.jade', { pretty: true });
pretty: true适用于开发环境,生产环境应关闭以节省带宽。
compileDebug：调试信息
当模板出现运行时错误，compileDebug: true会在错误信息中附带模板行号和源码片段,加快定位速度。
var fn = jade.compileFile('template.jade', { compileDebug: true });
线上环境建议关闭,避免泄露模板结构。
filename：定位错误
filename指定模板文件的绝对路径，用于继承和包含（extends/include）的基准路径,同时能提升错误提示的准确性。
jade.renderFile('template.jade', { filename: __dirname + '/views/template.jade' });
如果不设置，Jade默认以当前工作目录为基准,容易导致引用混乱。
其他选项
self：将局部变量绑定到self对象,防止污染全局命名空间。basedir：为extends和include设置根目录，与filename配合使用。doctype：自定义文档类型，默认输出html。
这些选项在复杂项目中能显著降低维护成本,建议根据实际场景组合使用。
Jade配置与Pug区别：迁移注意事项
由于Jade已更名为Pug，配置项和语法存在细微差异，如果你正在从Jade迁移到Pug，或在新项目中对比两者,以下区别值得关注。
| 对比项 | Jade | Pug |
|---|---|---|
| 扩展名 | .jade | .pug |
| 包名 | jade | pug |
| 配置参数 | pretty、compileDebug等 | 基本兼容，部分参数重命名 |
| 性能 | 稳定但不再更新 | 持续优化，微小差异 |
配置参数兼容性
Pug保留了Jade绝大多数配置接口，但pretty在Pug中改为pretty（名称相同），而compileDebug在Pug中默认启用，无需手动设置，如果你使用Pug,可以这样配置：
var pug = require('pug');
var html = pug.renderFile('template.pug', { pretty: true });
注意文件扩展名需改为.pug,否则Pug不会识别。
语法迁移要点
- 标签闭包写法：Jade中
div必须缩进子元素，Pug完全继承此规则,无变化。 - 属性括号：两者均支持
div(class="container")，但Pug推荐使用对象语法div(class="container"),无差异。 - 注释：Jade使用，Pug同样支持,但Pug新增了用于注释掉编译后的HTML。
行业共识认为，从Jade迁移到Pug的成本极低，只需修改扩展名和包名，配置参数几乎无需调整，如果你在旧项目中遇到依赖Jade的情况，建议逐步替换为Pug,以确保长期维护性。
Jade配置在Express中的实战场景
在Express框架中配置Jade作为模板引擎，是大多数开发者遇到的第一个实际场景,以下是一个完整的配置流程。
设置视图引擎
在Express应用入口文件app.js中添加：
var express = require('express');
var app = express();
app.set('view engine', 'jade');
app.set('views', __dirname + '/views');
view engine指定模板引擎为Jade，views设置模板文件存放目录。
渲染模板
在路由中使用res.render传递数据：
app.get('/', function(req, res) {
res.render('index', { title: '首页', message: '欢迎' });
});
对应的views/index.jade
html
head title
body
h1= message用于输出变量值,也可用于字符串插值。
配置缓存与调试
生产环境下建议开启模板缓存,减少重复编译：
app.set('view cache', true);
同时关闭pretty输出以优化性能，开发环境则相反，开启pretty和compileDebug便于调试。
关于Jade配置的常见问题
Jade配置时如何压缩输出HTML？
在Jade配置中，将pretty设置为false（默认值）即可输出紧凑格式，若需要进一步压缩，可结合html-minifier等工具在渲染后处理,Pug中同样有效。
Jade配置是否支持自定义过滤器？
支持，通过jade.filters对象可以注册自定义过滤器，例如将Markdown转换为HTML，操作步骤：定义过滤器函数，然后通过管道符在模板中调用，但需注意，Pug逐步废弃了过滤器接口,建议使用函数或混合。
Jade配置与Pug配置在团队协作中如何选择？
如果项目是全新启动，直接采用Pug是更稳妥的选择，因为其社区活跃且持续更新，如果维护遗留Jade项目，保持现有配置即可，无需主动迁移，两者语法互通，配置参数差异极小，切换成本可以忽略不计，据行业共识，多数团队在2017年后已转向Pug,但Jade的配置知识仍有参考价值。