Consul Template 默认单次渲染后退出，需去掉 -once 参数并配合 -exec 触发 SIGHUP 信号实现热更新；Go 程序须注册 syscall.SIGHUP 处理器、原子更新配置，且模板需正确处理空值与 KV 路径。
Consul Template 启动后配置没更新？检查 consul-template 的监听模式
Consul Template 默认是「单次渲染 + 退出」，不是常驻监听。你看到配置没变，大概率是因为它压根没在跑，或者启动时加了 -once 参数。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- 确认启动命令不含
-once，正确姿势是：consul-template -consul-addr=127.0.0.1:8500 -template="config.hcl:config.yaml" -exec="pkill -f myapp && ./myapp" -
-exec是热更新关键：它不会杀进程再拉起，而是触发 reload（需你的 Go 程序支持信号捕获，比如监听SIGHUP） - Consul Template 本身不推配置到进程内存，它只负责写文件 + 执行命令；Go 应用必须自己读新文件或响应信号
Go 程序怎么响应 Consul Template 的 reload？别硬轮询
轮询 config 文件修改时间（os.Stat）既低效又容易漏事件，而且和 Consul Template 的设计意图相悖——它本意是通过信号驱动。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- 在 Go 中注册
syscall.SIGHUP处理器：signal.Notify(sigChan, syscall.SIGHUP)，收到后重新加载配置（比如重读config.yaml） - 确保
-exec命令不使用sh -c包裹，否则信号会被 shell 吞掉；直接调用二进制或用exec.Command启动子进程 - 不要在 reload 时直接替换全局变量指针，而应原子更新（如用
sync/atomic或sync.RWMutex），避免并发读取时 panic
Consul Template 模板语法写错导致输出空文件？常见坑在 KV 路径和空值处理
模板里写 {{key "service/config/port"}} 却输出空字符串，不一定是 Consul 没数据，很可能是路径不存在、权限不足，或没处理 nil。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- KV 路径区分大小写，且默认不递归；查不到时先用
curl http://127.0.0.1:8500/v1/kv/service/config/port?raw直接验证 - 模板中必须显式判断空值：
{{with key "service/config/port"}}{{.}}{{else}}8080{{end}}，否则 nil 会转成空字符串，Go 程序解析 YAML 可能失败 - 如果 Consul 中存的是 JSON 字符串（比如
{"port": 8080}），不能直接key，得用json函数解析：{{json (key "service/config") }}
本地开发调试 Consul Template 很慢？关掉健康检查和冗余日志
Consul Template 默认每 30 秒向 Consul 发一次健康检查请求，还带一堆 debug 日志，本地改个配置等半分钟才生效，纯属干扰。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- 加参数禁用健康检查：
-disable-remain（注意不是-disable-remains，拼错就无效） - 用
-log-level=err降低日志量，避免被无关信息刷屏 - 开发时把
-wait改短：-wait=2s:10s，让模板更快响应变更（生产环境再调回默认）
Consul Template 和 Go 程序之间没有魔法连接，所有“热更新”都靠文件落地 + 信号传递 + Go 主动响应这三步咬合。哪一环松了，更新就断在半路。最常被忽略的是 Go 进程是否真的收到了 SIGHUP——建议加一行 log 打印信号接收，别只信文档说“支持”。
