Vapor4.77+Leaf4.2.4：父Leaf模板无法渲染子Leaf求助

核心标签正确用法梳理 #

先明确Leaf三个模板复用标签的适用场景，避免混淆：

• #embed("模板名")：直接嵌入整个目标模板的内容，无需继承关系，适合独立复用的小片段
• #extend("父模板名")：子模板继承父模板，需配合父模板的#export定义可替换区块
• #import("区块名")：在父模板中导入子模板通过#export定义的内容，必须和#extend配合使用

针对你的问题的具体解决方案 #

场景1：直接嵌入子模板（用#embed） #

如果只是想把child.leaf的内容直接插入parent.leaf，无需继承：

• parent.leaf 代码：

<!DOCTYPE html>
<html>
<head>
    <title>#(title)</title>
</head>
<body>
    <h1>父模板内容</h1>
    <!-- 直接嵌入子模板 -->
    #embed("child")
</body>
</html>

• child.leaf 代码（无需任何继承标签）：

<div class="child-content">
    <p>这是子模板的内容</p>
</div>

• 路由代码：

func routes(_ app: Application) throws {
    app.get { req async throws in
        return try await req.view.render("parent", ["title": "测试页面"])
    }
}

场景2：模板继承（用#extend + #import） #

如果需要子模板替换父模板的指定区块：

• parent.leaf 代码（定义可导出区块）：

<!DOCTYPE html>
<html>
<head>
    <title>#(title)</title>
</head>
<body>
    <h1>父模板固定内容</h1>
    <!-- 导入子模板的body区块 -->
    #import("body")
</body>
</html>

• child.leaf 代码（继承父模板并导出区块）：

#extend("parent")
#export("body") {
    <div class="child-body">
        <p>这是子模板替换的内容</p>
    </div>
}

• 路由代码（此时要渲染子模板，而非父模板）：

func routes(_ app: Application) throws {
    app.get { req async throws in
        return try await req.view.render("child", ["title": "继承测试"])
    }
}

关键排查步骤 #

1. 文件名检查：确认模板文件名完全匹配（Linux/macOS区分大小写，比如Child.leaf和child.leaf是两个文件）
2. 清理模板缓存：Vapor默认会缓存模板，修改模板后需重启服务，或者在开发环境关闭缓存：

   app.views.cache.isEnabled = false
   

3. 语法检查：确保标签的引号是英文双引号，没有拼写错误（比如把#embed写成#embend）
4. 路径检查：确认所有模板都放在Resources/Views目录下（Vapor默认的模板路径），如果自定义路径需在配置中指定：

   app.views.directory = app.directory.viewsDirectory // 默认路径，若自定义需修改此处
   

内容的提问来源于stack exchange，提问作者Frederick C. Lee