Air项目中的模板文件热重载问题解析

在Go语言开发中，热重载功能可以显著提升开发效率。Air作为一款流行的Go语言热重载工具，其最新版本引入了实时重载功能，但在实际使用中，开发者可能会遇到模板文件(.tmpl)修改后浏览器不自动刷新的问题。

问题现象

开发者在使用Air的实时重载功能时发现，当修改.tmpl模板文件后，浏览器页面不会自动刷新。这种情况在使用templ模板引擎的项目中尤为常见。经过排查，发现问题的核心在于代理端口的配置。

问题根源

Air的实时重载功能依赖于代理机制。当开发者直接访问应用端口(如3000)而非代理端口(如3001)时，实时重载功能将无法正常工作。这是因为实时重载的JavaScript脚本是通过代理端口注入到页面中的。

解决方案

要解决这个问题，需要在Air的配置文件中明确设置代理相关参数：

[proxy]
  enabled = true
  proxy_port = 3001
  app_port = 3000

配置完成后，开发者需要确保通过代理端口(3001)访问应用，而非直接访问应用端口(3000)。这样，当.tmpl文件被修改时，Air会触发重建，并通过注入的JavaScript脚本通知浏览器自动刷新。

注意事项

1. 确保Air版本为1.52.0或更高
2. 检查配置文件中已包含.tmpl扩展名
3. 使用lsof命令检查是否有旧进程占用端口
4. 确认浏览器页面中包含实时重载的JavaScript脚本

最佳实践

对于使用templ等第三方模板引擎的项目，建议在配置文件中明确指定所有相关文件扩展名：

include_ext = ["go", "tpl", "tmpl", "html", "templ"]

同时，开发过程中应养成通过代理端口访问的习惯，以确保实时重载功能正常工作。当遇到问题时，可先检查端口占用情况，并确认配置正确性。

通过正确配置和使用，Air能够为Go语言开发提供流畅的热重载体验，显著提升开发效率。