Leaf模板#extend与#export标签扩展失效问题求助

1. 确认Leaf版本与语法匹配 #

Leaf 4+的#extend/#export语法与旧版（Leaf 3及更早）的#template/#replace完全不兼容，先确保代码和当前使用的Leaf版本对应：

• 父模板index.leaf（定义可导出块）：

  <!DOCTYPE html>
  <html>
  <head>
      <title>#export("title")Default Title#endexport</title>
  </head>
  <body>
      #export("content")
          Default Content
      #endexport
  </body>
  </html>
  

• 子模板child.leaf（继承并填充内容）：

  #extend("index")
      #export("title")Child Page Title#endexport
      #export("content")
          <h1>This is the child page content</h1>
      #endexport
  #endextend
  

2. 检查模板文件路径 #

Vapor默认模板存放路径为Resources/Views，确认child.leaf和index.leaf都在该目录下。若使用自定义路径，需在configure.swift中明确配置：

app.views.use(.leaf)
// 自定义路径示例
LeafConfiguration.rootDirectory = app.directory.viewsDirectory + "/custom-subfolder"

3. 验证路由配置 #

确保路由返回的是正确的子模板，且模板名不带.leaf后缀：

app.get("child") { req async throws -> View in
    return try await req.view.render("child")
}

4. 禁用Leaf开发缓存 #

开发环境下Leaf默认会缓存模板，修改内容后需禁用缓存并重启服务器：

if app.environment == .development {
    app.leaf.cache.isEnabled = false
}

5. 调试渲染结果 #

直接打印渲染后的HTML，排查是模板解析问题还是服务器输出问题：

app.get("debug-child") { req async throws -> String in
    let html = try await req.view.render("child").render()
    print(html)
    return html
}

• 若打印内容正确，问题可能出在浏览器缓存或响应头配置；
• 若打印仍为默认内容，说明模板继承逻辑未生效。

6. 排查语法错误 #

• 确保所有#extend/#export标签都正确闭合（漏写#endextend/#endexport会导致解析失败）；
• 不要混用#import与#extend语法，#import用于导入模板片段，和继承功能冲突；
• 避免标签内引号嵌套错误，可交替使用单双引号或转义：

  #export("title")'Child' Page Title#endexport
  

原因总结 #

1. 版本不兼容：使用了与当前Leaf版本不匹配的模板语法；
2. 路径错误：模板文件未放在Leaf的搜索路径内；
3. 缓存残留：开发缓存导致修改后的模板未被加载；
4. 语法错误：标签未闭合、混用不兼容标签或引号嵌套错误；
5. 路由错误：路由返回了错误的模板文件。

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