fsnotify官方库（github.com/fsnotify/fsnotify）是当前唯一维护、生产可用的方案，go-fsnotify已废弃且无法编译运行；其最后一次提交为2015年v1.0.0，不支持Go module，依赖gopkg.in/fsnotify.v1在Go 1.11+下解析失败，且非官方分支。
Go-fsnotify 已于 2017 年归档，fsnotify 官方库（github.com/fsnotify/fsnotify）才是当前唯一维护、生产可用的文件系统事件监听方案。直接用 go-fsnotify 会编译失败或触发 panic。
为什么不能用 go-fsnotify
该仓库早已停止维护，最后一次提交在 v1.0.0（2015 年），且未适配 Go module；其内部依赖的 gopkg.in/fsnotify.v1 在 Go 1.11+ 下无法解析，运行时常见错误：cannot find package "gopkg.in/fsnotify.v1" 或 undefined: fsnotify.Watcher。
- 它不是
fsnotify的别名或分支，而是另一个已废弃的 fork - 所有文档、示例、issue 都指向
github.com/fsnotify/fsnotify - Go 官方生态中没有任何标准库或主流框架引用
go-fsnotify
正确引入和初始化 fsnotify.Watcher
使用 github.com/fsnotify/fsnotify 时，必须显式创建并管理 fsnotify.Watcher 实例，它不是全局单例，也不自动复用。
- 用
fsnotify.NewWatcher()创建实例，返回*fsnotify.Watcher和 error - 必须在 defer 或 shutdown 逻辑中调用
w.Close()，否则 fd 泄露（Linux 下表现为too many open files） - 监听路径需是**绝对路径**；相对路径（如
"./config"）在服务以 systemd 或 docker 启动时极易失效 - 只监听目录，不支持直接监听单个文件（但可通过监听父目录 + 过滤事件实现）
w, err := fsnotify.NewWatcher()
if err != nil {
log.Fatal(err)
}
defer w.Close()
err = w.Add("/etc/myapp/config") // 必须是目录
if err != nil {
log.Fatal(err)
}
如何安全处理 fsnotify.Events
Watcher.Events 是一个无缓冲 channel，若消费不及时（比如阻塞 IO、长耗时处理），会导致写入 goroutine hang 死 —— 这是最常见的服务卡死原因。
立即学习“go语言免费学习笔记（深入）”；
- 永远不要直接 range
w.Events；必须用 select + timeout 或启动独立 goroutine 消费 - 每个
fsnotify.Event包含Op（位运算组合：fsnotify.Write、fsnotify.Create等），需按需判断，而非只看Name -
Rename和Remove事件可能伴随Write（例如编辑器保存时先写临时文件再 rename） - Linux 下 inotify 有 limit，默认 8192，大目录监听前建议检查：
cat /proc/sys/fs/inotify/max_user_watches
监控配置文件变动的最小可靠模式
监听配置目录时，要容忍编辑器行为（如 vim 生成 .swp、nano 写临时文件）、原子写入（rename）、权限变更等干扰。
- 只响应
fsnotify.Write和fsnotify.Create，忽略Chmod和Remove（除非你明确需要清理缓存） - 对
Event.Name做后缀/前缀过滤，跳过.swp、~、.tmp等临时文件 - 读取新配置前加锁，避免并发 reload 导致结构体字段竞争
- 推荐用
filepath.Base(e.Name)判断是否为目标文件，而不是字符串 contains
go func() {
for {
select {
case event, ok := <-w.Events:
if !ok {
return
}
if (event.Op&fsnotify.Write == fsnotify.Write || event.Op&fsnotify.Create == fsnotify.Create) &&
filepath.Base(event.Name) == "app.yaml" {
reloadConfig(event.Name)
}
case err, ok := <-w.Errors:
if !ok {
return
}
log.Printf("fsnotify error: %v", err)
}
}
}()
真正麻烦的不是监听本身，而是事件语义的不确定性：同一个“保存操作”在不同编辑器、不同 OS 上触发的事件序列完全不同。生产环境务必做事件聚合（例如 500ms 去抖）和文件内容校验（比对 checksum），不能只信事件类型。
