Sublime 打开 .pug 文件显示 Plain Text 是因未绑定后缀，需手动设置：右下角选 Pug → Open all with current extension as… → 确认 Pug，生成正确语法配置。

Sublime 打开 .pug 文件显示 Plain Text 怎么办

不是插件没装好，是 Sublime 根本没把 .pug 后缀和 Pug 语法绑定。Package Control 安装的 Pug 插件只提供 Packages/Pug/Pug.sublime-syntax 文件，不自动注册扩展名。

• 打开任意 index.pug 文件，点击右下角显示的 Plain Text
• 在弹出菜单中选 Pug（若没有该选项，说明插件未加载成功，重启 Sublime 或重装 Pug 包）
• 再点右下角语言名（此时应显示 Pug），选 Open all with current extension as… → 确认选 Pug
• 这会写入 Packages/User/Preferences.sublime-settings，生成形如：

  { "extensions": ["pug"], "syntax": "Packages/Pug/Pug.sublime-syntax" }

  的配置
• 注意：syntax 值必须大小写严格匹配、以 Packages/ 开头、后缀为 .sublime-syntax（不是 .tmLanguage）

Express 项目里 res.render() 报错 “Failed to lookup view”

常见于路径配置错误或模板文件缺失，和 Pug 版本无关，但容易被误判为语法问题。

• app.set('views', './views') 中的路径是相对于 process.cwd()（即启动命令所在目录），不是 app.js 所在目录
• 确保 views 目录存在且含 index.pug（不是 index.jade，旧名已弃用）
• 检查 app.set('view engine', 'pug') —— 必须是 pug，不能写成 jade 或 Pug（大小写敏感）
• 若用 express-generator 初始化项目，默认已配好 Pug，但需确认是否手动删过 views 目录或改过 app.set 路径
• 启动服务前运行 ls views/（macOS/Linux）或 dir views（Windows）验证文件存在

pug.compileFile() 在 Node.js 里本地编译模板失败

这个函数常用于预编译或 CLI 场景，但默认不处理相对路径，也不自动读取 include 或 extends 的依赖文件。

用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

• 传入绝对路径：用 path.resolve(__dirname, 'views/layout.pug') 替代 'views/layout.pug'
• 若模板含 include header，需确保 header.pug 与当前文件同目录，或显式指定 basedir 选项：

  pug.compileFile('layout.pug', { basedir: path.join(__dirname, 'views') })

• 错误信息如 Error: ENOENT: no such file or directory, open 'header.pug' 就是 basedir 缺失导致的
• 开发期建议直接用 res.render()；compileFile() 更适合构建时生成静态 HTML 或做性能压测

Pug 模板里 #{variable} 渲染为空或报错

这是变量作用域和转义逻辑混淆的典型表现，不是数据没传进去，而是写法或上下文不对。

• #{} 是非转义插值，仅用于属性值内（如 a(href='/#{url}') Link），不能用在文本节点中——那里该用 =
• 文本内容统一用 = variable，例如 p= message；若 message 是字符串，它会被 HTML 转义；需要原样输出则用 != message
• 检查传递的数据结构：若 res.render('page', { user: { name: 'Alice' } })，模板中写 p= user.name 才对，p= name 会 undefined
• 调试技巧：在模板开头加 - console.log(locals)（仅开发环境），看实际注入的对象结构

Pug 的缩进语义和变量作用域规则非常严格，但错误往往不报语法异常，而是静默渲染为空或结构错乱。最有效的排查方式是先确认 .pug 文件语法高亮正常，再逐层验证路径、变量名、插值符号三者是否匹配。