Golang 变量作用域的坑，我踩过你踩过的坑

“我吹过你吹过的晚风” ......

最近在使用 gin + gorm 遇到两个问题，困了我一天一夜，终于在第二天搞明白了。

第一问题：全局变量与局部变量名称可以相同

package model

import (
	"fmt"
	"gin-app/config"
	"log"
	"time"

	"gorm.io/driver/mysql"
	"gorm.io/gorm"
	"gorm.io/gorm/schema"
)

// 在这里声明了全局变量
var db *gorm.DB

func InitDB() {
	mysqlConfig := config.Bases.Mysql

	dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8&parseTime=True&loc=Local",
		mysqlConfig.Username,
		mysqlConfig.Password,
		mysqlConfig.Host,
		mysqlConfig.Port,
		mysqlConfig.Dbname)

	db, err := gorm.Open(mysql.New(mysql.Config{
		DSN:                       dsn,   // DSN data source name
		DefaultStringSize:         191,   // string 类型字段的默认长度
		DisableDatetimePrecision:  true,  // 禁用 datetime 精度，MySQL 5.6 之前的数据库不支持
		DontSupportRenameIndex:    true,  // 重命名索引时采用删除并新建的方式，MySQL 5.7 之前的数据库和 MariaDB 不支持重命名索引
		DontSupportRenameColumn:   true,  // 用 `change` 重命名列，MySQL 8 之前的数据库和 MariaDB 不支持重命名列
		SkipInitializeWithVersion: false, // 根据版本自动配置
	}), &gorm.Config{
		NamingStrategy: schema.NamingStrategy{
			//TablePrefix:   "tb_", // 表前缀
			SingularTable: true, // 禁用表复数
		},
	})

	if err != nil {
		log.Fatalf("models.Setup err: %v", err)
	}

	sqlDB, _ := db.DB()
	sqlDB.SetMaxIdleConns(10)
	sqlDB.SetMaxOpenConns(10)
}

package model

import (
	"time"

	"gorm.io/gorm"
)

type AdminUser struct {
	ID        uint `gorm:"primaryKey"`
	CreatedAt time.Time
	UpdatedAt time.Time
	DeletedAt gorm.DeletedAt `gorm:"index"`
	Name      string
}

func GetAdminUser() {
	var aus AdminUser
	db.Find(&aus)
}

package main

import (
	"gin-app/model"
)

func main {
	model.InitDB() // 初始化数据库
	model.GetAdminUser() // 报错
}

// 执行后错误信息
panic: runtime error: invalid memory address or nil pointer dereference
[signal SIGSEGV: segmentation violation code=0x2 addr=0x28 pc=0x143bb46]

原因：在 db, err := gorm.Open() 这一句使用的是 := 短变量声明语句，新声明了一个db和err局部变量, golang中全局变量与局部变量名称可以相同，局部db的赋值不代表全局的db被赋值，他们是两个变量。 由于后面的代码没有使用这个局部的db变量导致报错。

解决: 不要再声明新的局部变量，直接使用 = 进行赋值操作。

db, err = gorm.Open()

第二问题：在 main 定义一个全局变量，在函数内居然未定义

package main

var num int64 = 10

func main {
	model.GetAdminUser() // 报错
}

package model

func GetAdminUser() {
	fmt.Print(num)
}

// 执行后报错信息
model/adminUser.go:19:12: undefined: num

这个问题有点傻X，但是新手还是容易犯错，也曾困扰了我片刻。

原因：在golang中，全局变量的生命周期属于整个包，在main包定义的全局变量无法被其他包引用。

总结：

声明了一个全局变量之后，如果再声明一个同名局部变量，该同名局部变量的声明周期为花括号内。

全局变量的生命周期属于当前整个包，其它包无法使用。

变量或函数名首字母小写只有作用于包内，首字母大写可以在包外调用。