讲师中心 微信公众号
AI工具推荐 视频效率加速

Golang开发热重载工具配置_Air与Fresh使用指南

老宇姑娘_7906

老宇姑娘_7906

发布时间:2026-02-12 11:32:57

|

1025人浏览过

|

来源于php中文网

原创

Go热重载不能直接反复go run,因每次启动新进程而旧进程未清理导致端口占用,且go run无文件监听能力;需借助air或fresh等工具实现构建、优雅重启与信号转发。

golang开发热重载工具配置_air与fresh使用指南

Go 热重载为什么不能直接 go run 反复执行?

因为 go run 每次都编译新进程,旧进程没被清理,端口会报 address already in use;同时无法监听文件变化,纯手动 Ctrl+C + 重新敲命令,效率低且易漏。

  • 真实场景:改一行 main.go 就得切终端、杀进程、再 go run,调试 HTTP 服务时尤其烦躁
  • 根本原因:Go 官方不内置热重载,得靠外部工具接管构建 + 启动 + 信号转发生命周期
  • 关键约束:工具必须能捕获 SIGHUP 或类似信号,优雅终止旧进程后再拉起新实例,否则 socket 资源泄漏

Air 配置文件 .air.toml 必须写的三处

air 强依赖配置文件,空跑或只改命令行参数大概率失败——它默认不扫描子目录、不重载 go.mod、甚至忽略 vendor/ 变更。

  • root = ".":显式指定项目根目录,否则可能从 $PWD 开始扫描,遇到嵌套模块就错位
  • tmp_dir = "tmp":必须设为不存在的目录名(air 会自动创建),否则并发多次保存时生成的临时二进制可能冲突
  • include_ext = ["go", "tpl", "tmpl", "html"]:加 "env" 如果用 godotenv,加 "sql" 如果模板里拼 SQL,漏掉就等于“改了但没热重载”

示例最小可用配置:

[build]
  cmd = "go build -o ./tmp/main ."
  bin = "./tmp/main"
  include_ext = ["go", "env"]
  exclude_dir = ["assets", "node_modules", "tmp"]

[watch]
  exclude_dir = ["tmp", "vendor"]

Fresh 启动报 fork/exec ./runner: no such file or directory

这是 fresh 的经典陷阱:它默认找当前目录下的 runner 二进制,但 Go 项目几乎不用这个名字,也不自动生成。

Golang Uber Dig
Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等

下载

立即学习“go语言免费学习笔记(深入)”;

  • 错误做法:手动 go build -o runner . —— 下次改代码后 fresh 仍运行旧二进制,因为没触发重建
  • 正确解法:在 fresh.conf 里写死 BuildCmd,例如 BuildCmd = "go build -o tmp/app .",再配 RunCmd = "tmp/app"
  • 兼容性注意:fresh 不支持 GOOS=js 或交叉编译,Windows 上路径分隔符要用 \,否则 RunCmd 找不到 exe

Air 和 Fresh 在 module 多级嵌套时的行为差异

当项目含 cmd/api、internal/pkg、pkg/lib 多个 go.mod 时,两者处理方式截然不同。

  • air 默认只认根目录的 go.mod,子模块变更不会触发重载——必须在 .air.toml 的 watch.include_dir 里手动加 ["cmd", "internal", "pkg"]
  • fresh 根本不解析 go.mod,只按文件路径匹配,所以只要 include_ext 覆盖了所有 .go 文件,多模块也能 reload,但可能误触无关构建
  • 性能影响:air 的模块感知更准,但配置复杂;fresh 简单粗暴,小项目快,大项目 watch 文件过多会卡顿

真正容易被忽略的是:两者都不监控 go.sum 变更。升级依赖后,必须手动重启工具,否则新包代码不会生效。

热门AI工具

更多
创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

519

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

616

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1216

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

791

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1786

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

5094

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

2354

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

4226

2025.06.17

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn