GoLand中用fresh启动Gin服务最省事，直接在Terminal运行fresh即可实现热加载；需确保已安装fresh、项目含go.mod，且关闭GoLand“Build project automatically”避免冲突。
GoLand里用 fresh 启动 Gin 服务最省事
直接在 GoLand 的 Terminal 里跑 fresh 是当前最轻量、兼容性最好的热加载方式，不需要额外配置文件或全局状态管理。
常见错误现象：fresh 启动后改了代码没反应，或者报 command not found；根本原因是没装、没加到 PATH、或项目没初始化 go mod。
- 先确保已安装：
go install github.com/pilu/fresh@latest（Go 1.21+ 推荐用@latest） - 项目根目录必须有
go.mod，没有就执行go mod init your-project-name - GoLand Terminal 中直接运行
fresh，它会自动找main.go；如果入口不是main.go，用fresh -c ./cmd/server/main.go指定 -
fresh默认监听.go和.tmpl文件，如需监听.yaml或.env，加参数：fresh -w config.yaml -w .env
realize 在 GoLand 中容易卡死或权限报错
realize 虽然功能全，但在 GoLand 的集成终端中常因信号处理异常导致进程残留、端口占用、或反复提示 permission denied，尤其 macOS / Windows WSL 下更明显。
使用场景：仅当你需要多服务联动（比如同时启 Gin + Redis + mock server）且愿意手动维护配置时才考虑它。
- 不要用
realize init生成默认配置，它会写一堆无用字段；手动生成最小化.realize.yaml： settings: mode: "auto" files: - "*.go" - "config/*.yaml" commands: - command: "go run main.go"- 启动前务必检查 GoLand 的 Terminal 是否以当前项目根目录为工作路径，否则
realize start会找不到main.go - 遇到卡死：先在 Terminal 执行
pkill -f realize清掉残留进程，再删掉.realize目录重来
Gin 自身不支持热加载，所有工具都只是“重启进程”
这是最容易被误解的一点：Gin 没有内置热加载能力，fresh、realize、甚至 VS Code 的 dlv-dap 调试器，本质都是监听文件变化 → 杀掉旧进程 → go run 新进程。所以每次修改都会重置内存状态（比如全局 map、连接池），不能替代真正的热更新（如函数级 patch）。
性能影响：小项目几乎无感；但如果你的 main() 里做了耗时初始化（如加载大模型权重、读取 GB 级配置），每次保存都会卡 2–3 秒，这时应把初始化逻辑拆进 lazy init 或用 init() 配合标志位控制。
- 避免在
main()中调用gorm.Open()或redis.NewClient()后立刻Ping()，改用首次请求时懒连接 - 路由注册本身很快，但中间件里嵌了
log.Println()或未关闭的os.Open()句柄，会导致进程无法干净退出，进而让热加载失败
GoLand 设置里关掉 “Build project automatically” 反而更稳
GoLand 默认勾选了 “Build project automatically”，但它和 fresh 冲突——IDE 自己编译时会锁文件，fresh 就没法 fork 新进程，结果就是改完代码没反应，或者报 address already in use。
正确做法是彻底交由 fresh 管构建生命周期，IDE 只负责编辑与调试。
- 设置路径：
Settings → Tools → File Watchers→ 关掉所有启用的 watcher -
Settings → Go → Build Tags & Vendoring→ 把 “Build project automatically” 勾去掉 - 如果要用断点调试，别用 Run 按钮，改用
Debug → Attach to Process，等fresh启起来后再 attach 到它的子进程（PID 在 Terminal 第一行会打印）
实际开发中最容易被忽略的是：热加载工具对 init() 函数的处理。每次重启进程，init() 都会重新执行，但如果里面有并发写全局变量、或重复注册 HTTP handler（比如多次调用 http.HandleFunc），就会引发 panic 或路由覆盖。这类问题不会在日志里明说，只会表现为“某个接口突然 404” 或 “返回数据错乱”。
