Handlebars无法找到动态局部模板问题求助

问题根源 #

你遇到的报错是因为Handlebars默认不会将助手返回的字符串当作文件路径加载局部模板，而是把它当作已注册的partial名称去查找。同时它会自动移除文件扩展名（比如.hbs），所以才会出现找不到/absolute/path/to/_info的提示——你既没注册过这个名称的partial，Handlebars也不会主动读取你指定的路径文件。

解决方法 #

方法1：修改助手直接返回模板内容 #

让助手读取模板文件内容并编译渲染，无需依赖Handlebars的partial注册机制：

const fs = require('fs');

module.exports = {
  infoPartial: function(context, options) {
    const templatePath = '/absolute/path/to/_info.hbs';
    // 读取模板文件
    const templateContent = fs.readFileSync(templatePath, 'utf8');
    // 编译并渲染模板
    const template = options.handlebars.compile(templateContent);
    return template(context);
  }
};

调用时直接使用{{infoPartial}}（不需要{{> }}语法）。

方法2：配置自定义Partial解析器 #

给Handlebars配置自定义解析逻辑，让它能根据路径加载模板文件：

const fs = require('fs');
const handlebars = require('handlebars');

// 注册自定义解析器
handlebars.registerPartialResolver(function(partialName) {
  // 补全文件扩展名（如果需要）
  const templatePath = partialName.endsWith('.hbs') ? partialName : `${partialName}.hbs`;
  try {
    return fs.readFileSync(templatePath, 'utf8');
  } catch (err) {
    throw new Error(`Partial ${partialName} could not be found`);
  }
});

保留你原有的助手和模板调用即可：
助手代码不变：

module.exports = {
  infoPartial: function(context, options) {
    return '/absolute/path/to/_info.hbs';    
  }
};

模板调用{{> (infoPartial) }}就能正常加载。

方法3：提前注册Partial再调用 #

先将局部模板注册到Handlebars，再让助手返回注册的名称：

const fs = require('fs');
const handlebars = require('handlebars');

// 提前注册partial
const infoTemplate = fs.readFileSync('/absolute/path/to/_info.hbs', 'utf8');
handlebars.registerPartial('info', infoTemplate);

修改助手返回注册的partial名称：

module.exports = {
  infoPartial: function(context, options) {
    return 'info';    
  }
};

模板调用{{> (infoPartial) }}即可正常渲染。

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