GoLand本身不提供Go热编译原生能力，需依赖air等外部工具实现监听→构建→重启；File Watchers需精确配置监听路径、作用域及后缀白名单，并处理编辑器原子写入导致的事件遗漏问题。
GoLand 里热编译监听目录必须靠外部工具，不是内置功能
GoLand 本身不提供 Go 源码变动 → 自动构建 → 重启进程的原生能力。所谓“热编译”，实际是靠 air、fileboy 或 nodemon 这类外部工具监听文件，再调用 go build 和进程管理实现的。IDE 只负责启动和展示输出，别指望它自己解析 AST 或感知结构体变更。
用 File Watchers 绑定 air 命令时，监听路径怎么设才有效
File Watchers 插件能触发命令，但默认行为很粗糙：它只认文件保存动作，不区分是否改了 handler、config 或 test。要让它真正可用，得手动收紧范围：
- Watched Files 填
internal/handler/**/*.go, internal/config/**/*.go, cmd/**.go—— 别用**/*.go，否则改个xxx_test.go也重启 - Scope 必须选 “Project Files”，不能选 “All Places”，否则会误触 vendor 或 go.sum
- Working directory 设为项目根目录（即含
go.mod的那层），否则air找不到模块路径，报cannot find module providing package - Program 填
air，Arguments 留空（air会自动找air.yaml）；如果没配air.yaml，就填-c ./air.yaml - Advanced options 中勾选
Auto-save edited files to trigger the watcher，否则 Ctrl+S 不生效
监听非 .go 文件（比如 config.yaml）必须显式加后缀
air 默认只监听 .go、.mod、.sum，改了 config.yaml 完全没反应。这不是 bug，是设计如此。要让它响应配置变动，必须在 air.yaml 里声明：
watch: include_exts: [go, mod, sum, yaml, yml, toml, json]
注意：include_exts 是白名单，不是追加；漏掉 mod 或 sum，改依赖也不会重建。另外，Linux 下若监听数百个 YAML 文件，可能触发 inotify fd 限制，报 too many open files，此时得调大 /proc/sys/fs/inotify/max_user_watches 或改用轮询 fallback。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
收到文件事件后，为什么配置重载总失败或读到脏数据
编辑器（VS Code/vim）保存 config.yaml 时，几乎总是原子写入：先写 config.yaml~ 或 .config.yaml.tmp，再 rename 覆盖原文件。你监听的是原路径，fsnotify.Write 根本不会发到它身上。常见错误包括：
- 只判断
e.Op == fsnotify.Write—— 正确写法是e.Op&fsnotify.Write != 0，因为 Op 是位掩码 - 收到
Rename事件后立刻ioutil.ReadFile("config.yaml")—— 此时文件可能还没刷盘，得加time.Sleep(10 * time.Millisecond)或等os.Stat返回非零 size - 没过滤临时后缀，把
config.yaml~当成正式文件去解析，导致 YAML 解析 panic
真正稳的做法是：监听父目录（如 ./config），收到事件后用 filepath.Base(e.Name) 匹配目标文件名，再 strings.HasSuffix(e.Name, "~") 排除临时文件，最后 os.Stat(e.Name) 确认存在且 size > 0。
