应统一用 = 赋值而非 := 遮蔽外层变量，尤其在错误处理、循环累积等场景需提前声明；利用 go vet -shadow 检测遮蔽；包级与局部变量须命名差异化以避免歧义。
用 = 而不是 := 复用已有变量
遮蔽最常发生在想“更新”一个外层变量时，却误用了短声明 :=。比如函数开头声明了 err error，后面在 if 块里写 err := doSomething()，结果创建了一个新的局部 err，外层那个始终是 nil。
正确做法是统一用 = 赋值：
-
err已在函数顶部声明 → 后续所有地方都用err = doSomething() - 多返回值场景下，
if err := doSomething(); err != nil是合法的，但这个err仅在if块内有效，块外不可见 - 若需跨块使用错误，必须提前声明
var err error，再用=赋值
检查作用域层级，别在 if/for 里重声明同名变量
Go 的 if、for、switch 语句自带隐式代码块，哪怕没写 {}，其初始化语句和条件表达式也处于独立作用域。一旦在其中用 := 声明同名变量，就必然遮蔽外层。
常见翻车点：
立即学习“go语言免费学习笔记（深入）”；
-
for _, item := range items { val, err := process(item) }→err在每次循环迭代中都是新变量 -
if x > 0 { y := x * 2 }→y在if块外不可访问 - 想在循环中累积数据？先在外层声明
var results []string，再用results = append(results, ...)
用 go vet -shadow 主动检测潜在遮蔽
go vet 自带 -shadow 检查（注意：该 flag 在较新版本中已默认启用，但部分旧版需显式加），能发现大多数静态可识别的遮蔽模式。
执行方式：
-
go vet -shadow ./...（整个模块） -
go vet -shadow main.go（单文件） - CI 中建议加入，但要注意它不覆盖所有动态场景，比如闭包捕获循环变量这类运行时行为
输出示例：main.go:12:3: declaration of "err" shadows declaration at main.go:8:2 —— 直接定位行号和遮蔽关系。
包级变量与局部变量同名时，优先改名而非依赖作用域查找
包级变量 globalConfig 和函数内 globalConfig := loadConfig() 看似无害，但会带来三重隐患：
- 阅读者无法一眼判断当前用的是哪个
globalConfig - IDE 跳转可能指向错误定义
- 后续修改逻辑时，极易误操作外层变量
更稳妥的做法是命名差异化：
- 包级变量用
defaultConfig或globalConfigVar - 局部变量用
cfg、localConfig或带上下文前缀如httpConfig - 导入包名冲突时，强制用别名：
import yaml "gopkg.in/yaml.v2"，避免和变量yaml冲突
遮蔽本身不报错，但会让变量生命周期和归属变得模糊——真正危险的不是编译失败，而是逻辑静默失效。
