Go 原生 text/template 不支持在 {{ template }} 调用时动态重命名字段（如将 .Name 映射为 .UserName），必须通过 Go 侧预处理数据结构或选用支持变量别名的第三方模板引擎（如 pongo2）来解决。
go 原生 `text/template` 不支持在 `{{ template }}` 调用时动态重命名字段（如将 `.name` 映射为 `.username`），必须通过 go 侧预处理数据结构或选用支持变量别名的第三方模板引擎（如 pongo2）来解决。
在 Go Web 开发中，常需复用模板片段（如用户信息展示组件），但不同模板对结构体字段命名不一致——例如主模板 A 使用 .Name 和 .Type，而被嵌入的通用模板 B 严格依赖 .UserName 和 .UserType。此时，仅靠 {{ template "B" . }} 无法自动完成字段映射，因为 Go 标准库的 html/template 和 text/template 不提供运行时字段别名机制（如 {{ template "B" .Name as .UserName }} 是非法语法，会编译报错）。
✅ 正确解决方案一：Go 侧构造适配数据结构（推荐）
在渲染前，于 Go 代码中构建一个符合模板 B 预期结构的新数据对象：
// 假设原始数据结构
type UserContext struct {
Name string
Type string
}
// 渲染前构造适配模板 B 的结构
ctx.Data["userForTemplateB"] = map[string]interface{}{
"UserName": ctx.Data["Name"].(string),
"UserType": ctx.Data["Type"].(string),
}
// 或使用结构体（类型安全更佳）
type TemplateBData struct {
UserName string
UserType string
}
ctx.Data["userForTemplateB"] = TemplateBData{
UserName: ctx.Data["Name"].(string),
UserType: ctx.Data["Type"].(string),
}模板 A 中调用：
{{ template "B" .userForTemplateB }}模板 B 保持原样即可正常工作：
Username : {{ .UserName }}
Type : {{ .UserType }}⚠️ 注意：避免直接修改原始上下文（如 ctx.Data["UserName"] = ...），以防污染其他模板逻辑；建议使用独立键名（如 userForTemplateB）确保作用域隔离。
✅ 正确解决方案二：迁移到 pongo2（需权衡生态）
若项目允许引入第三方模板引擎，pongo2 提供了类似 Django 的 with 语句，支持字段重命名：
// Go 侧仍传原始数据
ctx.Data["user"] = UserContext{Name: "Alice", Type: "Admin"}
// 模板 A 中写法（pongo2 语法）
{% with user.Name as UserName, user.Type as UserType %}
{% include "template_b.html" %}
{% endwith %}对应 template_b.html：
Username : {{ UserName }}
Type : {{ UserType }}该方式语义清晰、模板层解耦度高，但需评估迁移成本（如放弃 html/template 的 XSS 自动转义特性，需手动启用 pongo2.WithAutoEscape(true)）。
总结
- ❌ Go 原生模板 不支持 {{ template "B" .Name as .UserName }} 类语法；
- ✅ 首选方案：在 Go 层做数据适配，生成符合目标模板契约的新数据对象，兼顾性能、可维护性与标准库兼容性；
- ✅ 进阶方案：对模板灵活性要求极高且可接受生态切换时，选用 pongo2 并利用其 with 语句实现声明式字段映射；
- ? 关键原则：模板应是“纯视图”，复杂数据转换逻辑应前置到 Go 业务层，而非尝试在模板中修补结构不匹配问题。
