Golang中函数的形参名和局部变量名重名会怎样？变量遮蔽【避坑】-Golang-PHP中文网

形参名与局部变量名重名会触发变量遮蔽，导致逻辑错乱或nil panic；go中形参本质是局部变量，用:=易误遮蔽，应启用go vet -shadow检查或改用=赋值、规范命名。

golang中函数的形参名和局部变量名重名会怎样？变量遮蔽【避坑】

形参名和局部变量名重名，会触发变量遮蔽——局部变量覆盖形参，但形参本身仍被初始化、参与函数调用流程；关键风险是逻辑错乱或 nil panic，尤其在 := 误用时。

形参本身就是函数作用域内的局部变量

Go 中函数形参（如 func foo(x int) 中的 x）在函数体内就是普通局部变量，作用域从函数开始到结束。因此，若在函数体内部再次声明同名变量（比如用 :=），就会遮蔽形参。

常见错误现象：

nil 指针 panic：形参是 *sql.DB 类型，但内部又写 db, err := sql.Open(...)，导致包级 db 未被赋值，后续调用 db.Query() 崩溃
逻辑失效：想修改形参指向的值，却因遮蔽后操作的是新变量，原形参未被触碰

使用场景举例：

var db *sql.DB // 全局

func InitDB(d *sql.DB) {
    db, err := sql.Open("mysql", "...") // ❌ 遮蔽了形参 d，也遮蔽了全局 db
    if err != nil {
        log.Fatal(err)
    }
    // 此处 db 是新局部变量，函数退出即销毁
}

正确做法是用 = 赋值，而非 :=：

如果目标是赋值给形参：d = someDB（需注意 Go 形参是传值，这样只改副本，通常无意义）
如果目标是赋值给全局变量：db = someDB（显式写变量名，不带 :=）
更推荐：直接返回 *sql.DB，由调用方决定是否赋给全局变量

为什么 `:=` 是遮蔽高发区？

:= 是声明 + 赋值的复合操作。只要左侧出现**之前未声明过的变量名**，就新建变量；若该名已在当前作用域（包括形参）中存在，则 Go 会检查右侧是否有**其他新变量**需要声明 —— 只要还有至少一个新变量，整个语句就转为“部分遮蔽”：已有变量被忽略，新变量被声明。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

典型陷阱：

db, err := sql.Open(...) 在形参含 db 的函数里 → db 被遮蔽，err 被声明
err := doSomething() 在已有形参 err error 的函数里 → err 被遮蔽，且类型可能不兼容（如 err 形参是 error，而右侧返回 int 就编译失败）