在 Go 中，当函数内定义了与包级常量或变量同名的局部变量时，局部变量会遮蔽（shadow）外部同名标识符，且语言不支持通过限定符（如 package.name）直接访问被遮蔽的顶层标识符。

在 go 中，当函数内定义了与包级常量或变量同名的局部变量时，局部变量会遮蔽（shadow）外部同名标识符，且语言不支持通过限定符（如 `package.name`）直接访问被遮蔽的顶层标识符。

Go 的作用域规则明确规定：内层块中声明的同名标识符会完全覆盖外层同名标识符的可见性。这意味着一旦你在 main 函数中写下 name := "Jobs"，该局部变量 name 就成为当前作用域中唯一可直接引用的 name，而包级常量 const name = "Yosua" 在此作用域内不可直接访问。

❌ 错误尝试：无法使用限定符访问

Go 不支持类似 main.name 或 global.name 这样的语法来显式引用包级变量（这与 Python 的 global 或 Java 的 ClassName.field 有本质区别）。以下写法均非法：

// 编译错误：undefined: main.name（Go 不允许这种限定访问）
fmt.Println(main.name)

// 编译错误：cannot refer to package-level name in local scope
fmt.Println(.name) // 不存在的语法

✅ 正确解决方案

方案 1：避免命名冲突（推荐）

最清晰、符合 Go 风格的做法是为局部变量选用不同名称，从根本上消除遮蔽：

package main

import "fmt"

const userName = "Yosua" // 使用语义化、区分度高的名字

func main() {
    currentName := "Jobs" // 明确表达局部含义
    fmt.Println(currentName) // Jobs
    fmt.Println(userName)    // Yosua
}

方案 2：提前保存顶层值（适用于临时需求）

若因历史原因或接口约束必须保留局部变量名，可在声明局部变量前“快照”包级值：

func main() {
    savedName := name // 先读取并保存顶层常量
    name := "Jobs"    // 再声明同名局部变量
    fmt.Println(name)      // Jobs
    fmt.Println(savedName) // Yosua
}

方案 3：封装为函数（提升可测试性与复用性）

将顶层值的访问逻辑封装成函数，既解耦又便于单元测试：

func getAuthorName() string {
    return name // 返回包级常量
}

func main() {
    name := "Jobs"
    fmt.Println(name)         // Jobs
    fmt.Println(getAuthorName()) // Yosua
}

⚠️ 注意事项

• 遮蔽是隐式且不可逆的：只要局部变量在作用域内，顶层同名标识符即不可见——没有 super、global 或作用域解析操作符。
• 静态检查友好但易引发 bug：Go 编译器不会警告遮蔽（除非启用 govet -shadow），但 IDE（如 VS Code + gopls）通常会高亮提示，建议开启相关检查。
• 常量 vs 变量无差别：无论是 const 还是 var 声明的包级标识符，遮蔽规则完全一致。

总结：Go 的设计哲学强调明确性优于灵活性。与其依赖复杂的作用域解析机制，不如通过清晰的命名和结构化设计（如封装函数或重命名）来保证代码可读性与可维护性。始终优先选择方案 1 —— 它不仅是技术最优解，更是 Go 社区广泛遵循的最佳实践。