0

0

Golang中的init函数何时执行 剖析包初始化顺序规则

P粉602998670

P粉602998670

发布时间:2025-08-24 09:51:01

|

974人浏览过

|

来源于php中文网

原创

init函数在main函数之前执行,Go程序启动时先初始化依赖包:按深度优先处理包依赖,每个包内先初始化全局变量,再按声明顺序执行init函数,main包最后初始化,最终运行main函数。

golang中的init函数何时执行 剖析包初始化顺序规则

Go语言中的

init
函数,说白了,它就是个“幕后英雄”,总是在
main
函数执行之前,把该准备的都准备好。具体来说,当你的Go程序启动时,或者说,当一个包被引入(import)时,Go运行时会确保这个包里的所有
init
函数都跑一遍。而且,每个
init
函数只会执行一次,这是个非常重要的特性。

解决方案

init
函数的执行时机和包的初始化顺序紧密相连。你可以这样理解:当Go程序开始运行,它首先会解析所有的包依赖。这个过程就像在构建一个复杂的家谱图。从最没有依赖的包开始,Go会一步步地进行初始化。

对于每一个被初始化的包,流程是这样的:

  1. 包级别的变量初始化:所有在函数外部声明的变量,也就是全局变量,会按照它们在代码中出现的顺序被初始化。
  2. init
    函数执行
    :在所有包级别的变量都初始化完毕后,该包内定义的所有
    init
    函数会按照它们在源文件中出现的顺序依次执行。如果一个包有多个源文件,并且每个文件里都有
    init
    函数,那么这些
    init
    函数的执行顺序,Go语言规范并没有严格规定,但在实际操作中,它往往会按照文件名的字典序(lexicographical order)来执行,但这并不是一个你可以依赖的保证。所以,我个人建议,尽量不要让不同文件中的
    init
    函数之间存在隐式依赖,这会给维护带来不少麻烦。
  3. 依赖关系:如果一个包
    A
    依赖于包
    B
    ,那么包
    B
    会先于包
    A
    完成初始化(包括
    B
    的所有变量初始化和
    B
    的所有
    init
    函数执行)。这个过程会递归地进行,直到所有被导入的包都初始化完毕。
  4. main
    函数
    :只有当所有被导入的包都初始化完成,并且主(
    main
    )包自身的变量和
    init
    函数都执行完毕后,
    main
    函数才会开始执行。

这个机制保证了程序运行的确定性,确保了在业务逻辑开始之前,所有必要的配置、资源注册、状态设置都能到位。

立即学习go语言免费学习笔记(深入)”;

Go语言中init函数与main函数的执行顺序是怎样的?

这个问题,其实是Go程序启动流程的核心。简单讲,

init
函数总是在
main
函数之前执行,这是Go语言的铁律。我通常会把
init
函数看作是程序的“前奏曲”,它负责为
main
函数,也就是“正片”,做好一切铺垫。

具体的执行顺序是这样的: 假设你有一个

main.go
文件,里面引用了其他包。

  1. 导入包的初始化:Go会遍历所有被
    main
    包直接或间接导入的包。对于每一个这样的包,它会先初始化该包内的所有全局变量,然后执行该包内的所有
    init
    函数。这个过程是递归的,直到最深层的依赖包都被初始化完毕。
  2. main
    包的初始化
    :一旦所有导入的包都初始化完毕,Go就会开始初始化
    main
    包。同样地,先初始化
    main
    包内的所有全局变量,然后执行
    main
    包内的所有
    init
    函数。
  3. main
    函数执行
    :只有当上述所有步骤都完成后,
    main
    函数才会被调用,程序的主逻辑才真正开始运行。

来看个小例子,这能帮你更好地理解:

package main

import (
    "fmt"
    "myproject/mylib" // 假设有这么一个库
)

var globalVar = initGlobalVar()

func initGlobalVar() string {
    fmt.Println("main包:全局变量初始化")
    return "我是一个全局变量"
}

func init() {
    fmt.Println("main包:第一个init函数执行")
}

func init() {
    fmt.Println("main包:第二个init函数执行")
}

func main() {
    fmt.Println("main函数:程序开始执行")
    fmt.Println("globalVar:", globalVar)
    mylib.DoSomething() // 调用mylib包的函数
}

假设

myproject/mylib/mylib.go
内容如下:

package mylib

import "fmt"

var libVar = initLibVar()

func initLibVar() string {
    fmt.Println("mylib包:全局变量初始化")
    return "我是mylib的变量"
}

func init() {
    fmt.Println("mylib包:第一个init函数执行")
}

func init() {
    fmt.Println("mylib包:第二个init函数执行")
}

func DoSomething() {
    fmt.Println("mylib包:DoSomething函数执行")
}

运行这段代码,你会看到输出的顺序会是:

MagicArena
MagicArena

字节跳动推出的视觉大模型对战平台

下载
  1. mylib包:全局变量初始化
  2. mylib包:第一个init函数执行
  3. mylib包:第二个init函数执行
  4. main包:全局变量初始化
  5. main包:第一个init函数执行
  6. main包:第二个init函数执行
  7. main函数:程序开始执行
  8. globalVar: 我是一个全局变量
  9. mylib包:DoSomething函数执行

这个例子清晰地展示了,导入包的初始化发生在主包之前,而全局变量的初始化又发生在

init
函数之前。

Golang包的初始化顺序遵循哪些规则?

Go语言的包初始化顺序,不是随便来的,它遵循一套非常明确的规则,这套规则确保了程序的确定性和可预测性。对我而言,理解这些规则就像是掌握了一张Go程序的“生命周期图”,对于设计复杂的系统结构非常有帮助。

核心规则可以概括为:深度优先、拓扑排序

  1. 依赖优先原则:如果一个包

    P
    导入了包
    Q
    ,那么Go语言运行时会保证包
    Q
    在包
    P
    之前被完全初始化。这意味着
    Q
    的所有包级变量会被初始化,然后
    Q
    的所有
    init
    函数会执行,最后才会轮到
    P
    。这个过程是递归的,直到所有依赖链上的包都完成初始化。你可以想象成一棵依赖树,Go会从树的叶子节点(没有外部依赖的包)开始向上初始化。

  2. 单一初始化:每个包只会被初始化一次,即使它被多个其他包间接导入。Go运行时会跟踪哪些包已经被初始化,避免重复工作。这很关键,因为它意味着

    init
    函数里的操作是幂等的,你不需要担心它被重复执行带来的副作用。

  3. 避免循环依赖:Go语言不允许包之间存在循环导入(circular import)。如果在编译时检测到A导入B,B导入A这样的情况,编译器会直接报错。这是一种设计哲学,强制开发者将代码组织成一个清晰的、无环的依赖图,从而简化了初始化逻辑,也避免了运行时可能出现的死锁或无限循环。

  4. 内部顺序:在一个包内部,初始化顺序是:

    • 变量初始化:包级别的变量会按照它们在源代码中声明的顺序进行初始化。如果一个变量的初始化依赖于另一个变量,Go会确保被依赖的变量先初始化。
    • init
      函数执行
      :所有
      init
      函数会在所有包级变量初始化完成后,按照它们在源文件中出现的顺序依次执行。这里再次强调,对于同一个包内不同文件中的
      init
      函数,它们的执行顺序是未指定的(虽然实践中常按文件名字典序),因此,不要在它们之间建立隐式依赖。

举个例子,假设你的项目结构是这样的:

- myapp/
  - main.go
  - config/
    - config.go
  - db/
    - db.go
  - util/
    - util.go

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

179

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

228

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

340

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

209

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

392

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

197

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

191

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

13

2026.01.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
golang socket 编程
golang socket 编程

共2课时 | 0.1万人学习

nginx浅谈
nginx浅谈

共15课时 | 0.8万人学习

golang和swoole核心底层分析
golang和swoole核心底层分析

共3课时 | 0.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号