Gin模板传动态数据需结构体字段首字母大写，静态资源须用router.Static注册路径，HTML文件必须UTF-8编码并添加meta charset="utf-8"。
模板里怎么传入动态数据？
Gin 的 HTML 渲染不支持直接用 map[string]interface{} 以外的结构体字段名自动解析（除非显式注册），常见错误是字段没导出导致模板里取不到值——Go 结构体字段必须首字母大写才能被模板访问。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 定义简历结构体时，所有要渲染的字段必须首字母大写，比如
Name、Email，不能是name - 传参统一用
c.HTML(http.StatusOK, "resume.html", data)，其中data可以是结构体实例或map[string]interface{} - 如果用 map，键名要和模板中
{{ .Name }}里的名字完全一致，区分大小写 - 避免在模板里调用方法（如
{{ .GetPhone() }}），Gin 默认禁用方法调用，需手动启用template.FuncMap才能支持
静态资源（CSS/JS/图片）404 怎么办？
Gin 默认不自动提供静态文件，简历页面引用了 style.css 却返回 404，不是路径写错，而是根本没注册静态路由。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在
router.Static()中指定目录，例如r.Static("/static", "./static")，确保 HTML 中引用路径为/static/style.css - 模板里不要用相对路径如
./static/...或../css/...，Gin 不处理这类路径解析 - 检查文件权限：Linux 下若
static/目录不可读，也会 404，用ls -l static/确认 - 开发时可加个中间件临时打印请求路径，确认浏览器实际请求的是不是你预期的地址
中文乱码或特殊字符显示异常
生成的 HTML 页面打开后中文全是方块或问号，不是字体问题，而是 HTTP 响应头缺失 Content-Type 字符集声明。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 在
c.HTML()前无需手动设 Header，但必须确保模板文件本身是 UTF-8 编码（用 VS Code 或 Vim 查看文件编码，别用记事本保存） - 模板开头加
<meta charset="utf-8">，放在<head>最前面 - 如果用
template.ParseFiles()加载多个模板，确保所有文件编码一致；混用 GBK 文件会导致解析失败，报错类似template: xxx: unexpected EOF - 简历中若有邮箱、链接等用户输入内容，务必用
{{ .Email | html }}过滤，防 XSS——Gin 模板默认不自动转义，这点和 Django 不同
如何让同一套模板生成不同人的简历？
不是靠改代码，而是靠 URL 路径参数或查询参数驱动数据加载，比如访问 /resume?id=alice 渲染 Alice 的简历。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
c.Param("id")获取路径参数（如r.GET("/resume/:id", handler)），或c.Query("id")获取 query 参数 - 根据 id 查数据库或 JSON 文件，构造对应数据对象，再传给
c.HTML()；别把所有人数据都塞进一个 map 里再条件判断 - 注意缓存：Gin 默认不缓存 HTML 输出，但 Nginx 或浏览器可能缓存，开发时可在响应头加
c.Header("Cache-Control", "no-cache") - 如果简历含敏感信息（如身份证号），务必在数据层做权限校验，不能只靠前端隐藏字段
模板变量名拼错、静态路径漏注册、文件编码不统一——这三个点卡住的人最多。跑通前先用最简结构体和单个 .html 文件验证流程，别一上来就堆样式和多页路由。
