直接监听单个文件路径（如"plugin.yaml"）必然失败，必须监听其父目录并用filepath.base(event.name)过滤；需同时响应fsnotify.write和fsnotify.rename事件，优先处理rename以捕获编辑器原子写入的最终状态，并通过os.stat校验文件有效性。
直接监听单个文件路径（如 "plugin.yaml"）几乎必然失败，必须监听目录并过滤事件名；插件加载和执行不能共享同一 goroutine，否则一个 panic 会拖垮整个框架。
为什么 fsnotify.Add("plugin.yaml") 总是不触发
VS Code、vim、nano 等编辑器保存时默认走原子写入：先写 plugin.yaml.tmp，再 rename 覆盖原文件。原文件 inode 已失效，fsnotify 对该路径的监听句柄自动失效。
- 正确做法是用
filepath.Dir("plugin.yaml")获取父目录路径，调用watcher.Add()监听该目录 - 收到事件后，用
filepath.Base(event.Name)提取文件名，再判断是否等于"plugin.yaml" - 必须同时检查
event.Op & fsnotify.Write != 0和event.Op & fsnotify.Rename != 0，且优先响应Rename（它是原子完成信号） - 监听前务必
os.Stat确认目录存在且是真实目录，符号链接需先filepath.EvalSymlinks解析
插件定义文件怎么写才安全可加载
别用自由字段或嵌套 map，否则校验无力、循环依赖难发现、变更不可审计。最小可行结构应固定字段：
-
name：插件唯一标识，仅限字母数字和下划线 -
command：可执行文件绝对路径或相对路径（建议绝对路径，避免exec.LookPath失败） -
args：字符串数组，不拼接命令行，防空格/注入 -
trigger：支持file_write、file_create、timer三种类型，不支持通配符 - 缺失
command或trigger字段，reload 应立即返回 error 并 log，不静默忽略
示例：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
plugins: - name: "log_archiver" command: "/usr/local/bin/archive-log" args: ["--keep-days", "7"] trigger: "file_write" - name: "backup_notifier" command: "/opt/scripts/notify.sh" args: ["--channel", "ops"] trigger: "file_create"
插件执行必须隔离 panic、超时与进程生命周期
直接 exec.Command(plugin.Command, plugin.Args...).Run() 是高危操作：子进程卡死、panic 崩溃、SIGPIPE 都会中断主监听循环。
- 每插件启动独立 goroutine，并用
context.WithTimeout控制生命周期 - 包裹
defer func() { recover() }()捕获 panic，转为结构化 error 记录 - 用
errgroup.Group管理插件 goroutine，主循环可通过eg.Wait()统一等待或取消 - 子进程启动后，主动检查其 PID 是否存活（
kill -0 pid），避免僵尸残留 - 禁止在插件执行中直接修改全局状态（如
cfg），所有输出应通过 channel 或回调函数返回
热重载时如何避免配置撕裂和并发读错
把新解析出的插件列表直接赋值给全局变量 plugins，会导致正在遍历的 goroutine 读到部分初始化的 slice 或 nil map。
- 声明
var currentPlugins atomic.Value，类型为*[]Plugin - reload 成功后调用
currentPlugins.Store(&newPlugins) - 所有触发逻辑一律通过
currentPlugins.Load().(*[]Plugin)获取当前快照 - 若插件含内部状态（如计数器、连接池），应在
Store前显式关闭旧实例资源 - 不要在 reload 过程中触发新插件——用
atomic.Bool标记isReloading，worker 在执行前检查
真正容易被忽略的是：fsnotify 的事件可能乱序到达，Rename 和 Chmod 可能紧挨着发；你得靠 os.Stat 确认文件大小 > 0 且修改时间稳定，再进 reload 流程，否则可能加载到半截 YAML。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
