Golang全局变量使用规范

在Golang项目中，全局变量的使用应该遵循哪些规范？比如如何避免命名冲突、控制访问权限、保证线程安全等。我看到有些项目会尽量避免使用全局变量，而有些项目又大量使用，应该如何权衡？还有没有其他需要注意的最佳实践？

2 回复

Golang中应尽量避免使用全局变量，优先通过依赖注入传递。若必须使用，需确保：

  1. 使用var声明并初始化
  2. 包内变量以小写字母开头（私有）
  3. 若需跨包访问，通过Get/Set方法控制
  4. 注意并发安全，使用sync包加锁

更多关于Golang全局变量使用规范的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html


在Go语言中，全局变量应谨慎使用，遵循以下规范以确保代码的可维护性和可测试性：

1. 最小化使用

  • 优先使用局部变量或依赖注入，避免全局状态。
  • 全局变量可能导致隐式耦合、竞态条件，并增加测试复杂度。

2. 使用包级变量

在包内声明全局变量时，使用var关键字，并尽量限制其作用域：

package config

var AppName = "MyApp" // 包内可访问，外部需通过函数暴露

3. 避免可变全局状态

  • 声明为常量（const）或只读变量（如通过函数访问）：
    const DefaultPort = 8080

// 通过函数控制访问
private var dbConn *sql.DB
func GetDB() *sql.DB {
    return dbConn
}
  • 若需修改，使用sync包保证线程安全：
    var (
    counter int
    mutex   sync.Mutex
)
func IncrementCounter() {
    mutex.Lock()
    counter++
    mutex.Unlock()
}

4. 初始化控制

  • 使用init()函数谨慎初始化，避免复杂逻辑。
  • 显式初始化更易维护：
    var Logger *log.Logger

func InitLogger() {
    Logger = log.New(os.Stdout, "APP: ", log.Ldate|log.Ltime)
}

5. 命名规范

  • 采用驼峰命名，若需导出则首字母大写：
    var GlobalConfig Settings // 导出
var internalCache map[string]string // 不导出

6. 替代方案

  • 使用依赖注入传递配置或资源。
  • 通过结构体封装状态：
    type App struct {
    Config *Config
}
func NewApp(cfg *Config) *App {
    return &App{Config: cfg}
}

遵循这些规范可减少副作用，提升代码模块化与可测试性。

回到顶部