Gin模板路径必须相对于可执行文件所在目录而非源码目录，需在gin.Default()后、路由前调用LoadHTMLGlob或SetHTMLTemplate，并确保templates/与二进制同级；数据字段须导出且键名严格匹配，静态资源路径前缀须与模板中引用一致。
模板文件路径必须相对于可执行文件，不是源码目录
很多人把 templates/ 放在 cmd/ 或 internal/ 下，结果启动时报 html/template: "index.html" is undefined。Gin 的 LoadHTMLGlob 和 LoadHTMLFiles 是基于当前工作目录（os.Getwd()）查找文件的，不是编译路径或 go run 所在路径。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 启动服务前用
fmt.Println(os.Getwd())确认当前目录，再按此路径组织templates/子目录 - 推荐把
templates/放在项目根目录，和main.go同级；运行时确保从根目录执行go run main.go - 若需打包进二进制（如用
embed），不能依赖LoadHTMLGlob，得改用template.ParseFS+embed.FS
使用 HTMLRender 时注意 gin.Engine 初始化顺序
模板引擎必须在注册路由前设置，否则 c.HTML() 会 panic： render not initialized。这不是延迟加载问题，而是 Gin 内部 render 字段为 nil 导致的空指针调用。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先调用
r := gin.Default()，紧接着就调用r.LoadHTMLGlob("templates/**/*")或r.SetHTMLTemplate(tmpl) - 不要在中间件里、路由分组里或 handler 中初始化模板 —— 那已经太晚了
- 如果用了自定义
html/template实例（比如加了自定义函数），要用r.SetHTMLTemplate(t)，且确保t已执行过ParseGlob或ParseFiles
c.HTML() 的状态码和数据传递容易混淆
c.HTML() 默认发送 200 OK，但很多人误以为它会自动继承前面 c.Status() 的设置，实际上不会。同时，传入的数据 map 如果含未导出字段（小写开头），模板里取不到值 —— Go 模板只识别导出字段。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 需要非 200 响应（如 404）时，必须显式写
c.Status(404)，再调c.HTML()；顺序不能反 - 传给
c.HTML()的 data 参数推荐用 struct 而非 map[string]interface{}，便于类型检查和字段导出控制 - 避免在模板中直接访问
.CreatedAt这类时间字段 —— 它是time.Time，默认输出格式难读；应在 handler 中转成字符串或用自定义模板函数处理
静态资源与模板混用时，StaticFS 路径前缀影响模板中 href 和 src
如果用 r.StaticFS("/static", http.Dir("./static"))，那模板里引用 CSS/JS 必须写 /static/css/app.css；但如果漏掉开头的 /（比如写成 static/css/app.css），浏览器会按相对路径解析，很可能 404。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 静态资源路由前缀（第一个参数）必须以
/开头，且和模板中写的路径严格一致 - 开发时可在模板里加
{{ printf "%s" .Request.URL.Path }}临时调试当前请求路径，确认 base URL 是否符合预期 - 生产环境建议用 Nginx 托管静态资源，此时 Gin 不挂
StaticFS，模板路径仍按原逻辑写，只是服务端不处理这些请求
os.Getwd() 返回了 /tmp 或 /app，而不是你预设的项目结构。 
