Node.js新手遇express-handlebars渲染失败，求排查修复方案

嘿，我来帮你搞定这个express-handlebars的渲染问题！

问题根源 #

你碰到的错误核心是express-handlebars的初始化方式不对。当你直接写app.set('view engine', exphbs)时，express会误以为你传入的是一个模块名称，试图去加载它，但实际上你传的是一个工厂函数，这就导致了"Cannot find module..."的报错。

修复步骤 #

1. 正确初始化handlebars引擎 #

你需要先通过exphbs.create()创建一个完整的引擎实例，再把它注册到express中，同时指定视图文件的扩展名（如果你的文件是.html，得额外配置这个参数）。

2. 修改代码中的关键配置段 #

把原来的：

app.set('views', path.join(__dirname, 'views'));
app.set('view engine', exphbs);

替换成下面的代码：

app.set('views', path.join(__dirname, 'views'));
// 初始化handlebars引擎，指定视图文件扩展名
const hbs = exphbs.create({
  extname: '.html' // 如果你用.hbs扩展名，就改成'.hbs'
});
// 向express注册这个引擎
app.engine('html', hbs.engine);
// 设置默认视图引擎
app.set('view engine', 'html');

3. 确认视图文件存在 #

检查views文件夹下确实有index.html文件（如果改成.hbs扩展名，记得把文件名也改成index.hbs）。

修改后的完整代码片段 #

这里是调整后的核心代码部分：

require('./config/config');
const path = require('path');
const http = require('http');
const _ = require('lodash');
const express = require('express');
const bodyParser = require('body-parser');
const {ObjectID} = require('mongodb');
const socketIO = require('socket.io');
const exphbs = require('express-handlebars');

var {mongoose} = require('./db/mongoose');
var {Todo} = require('./models/todo');
var {User} = require('./models/user');
var {authenticate} = require('./middleware/authenticate');

var app = express();
var server = http.createServer(app);
var io =socketIO(server);

const port = process.env.PORT;
const publicPath = path.join(__dirname, './public');

app.use(bodyParser.json());

// 配置handlebars视图引擎
app.set('views', path.join(__dirname, 'views'));
const hbs = exphbs.create({
  extname: '.html' // 匹配你的视图文件扩展名
});
app.engine('html', hbs.engine);
app.set('view engine', 'html');

app.use(express.static(publicPath));

app.get('/', (req, res) => {
  res.render('index');
});

为什么这样能解决问题？ #

• exphbs.create()会生成一个包含所有编译逻辑的handlebars引擎实例，而不是直接用工厂函数。
• app.engine('html', hbs.engine)告诉express：遇到.html后缀的视图文件时，用我们创建的引擎来渲染。
• app.set('view engine', 'html')设置默认视图扩展名，这样res.render('index')会自动去寻找index.html文件。

内容的提问来源于stack exchange，提问作者Karlom