本文介绍 go 语言中跨包使用 flag 包解析命令行参数的正确方式，重点解决因 init() 执行时机早于 main 导致的 flag 未生效问题，并提供可复用、无循环依赖的安全初始化方案。
本文介绍 go 语言中跨包使用 flag 包解析命令行参数的正确方式，重点解决因 init() 执行时机早于 main 导致的 flag 未生效问题，并提供可复用、无循环依赖的安全初始化方案。
在 Go 程序中，flag 包的典型用法是先声明标志变量（如 flag.StringVar），再调用 flag.Parse() 解析命令行参数。但若将 flag 声明和解析逻辑错误地放在被导入包的 init() 函数中（如 configuration 包），就会引发严重时序问题：Go 规定所有导入包的 init() 函数均在 main() 执行前完成，此时 main 中尚未调用 flag.Parse()，导致 flag 值仍为默认值（如 "/defaultpath/config.gcfg"），进而造成配置文件读取失败。
因此，绝不可在 init() 中依赖尚未解析的 flag 值。正确的做法是将 flag 注册与解析逻辑封装为显式导出函数，由 main 包主动调用，确保执行顺序可控。
✅ 推荐解决方案：显式初始化函数
在 configuration/configuration.go 中，移除 init()，改为定义一个导出的 Init() 函数：
package configuration
import (
"flag"
"fmt"
"os"
"gopkg.in/gcfg.v1"
)
var (
configPath string
C *configuration
)
// Init 初始化配置：注册 flag、解析参数、加载配置文件
func Init() {
flag.StringVar(&configPath,
"config",
"/defaultpath/config.gcfg",
"Path to configuration file")
flag.Parse() // 关键：必须在此处解析，此时 main 已开始执行
C = &configuration{}
if err := gcfg.ReadFileInto(C, configPath); err != nil {
fmt.Printf("Cannot read configuration file. Program was terminated: %s", err)
os.Exit(1)
}
}
type configuration struct {
Queue struct {
User string
Host string
Port string
}
}
然后，在 main.go 中显式调用该函数：
package main
import (
"your-project/configuration" // 替换为实际 import path
)
func main() {
configuration.Init() // ✅ 保证 flag.Parse() 在配置加载前执行
// 后续业务逻辑可安全使用 configuration.C
// 例如：fmt.Println("Queue user:", configuration.C.Queue.User)
}
⚠️ 注意事项与最佳实践
-
禁止循环依赖：
main包不能 import 自身，因此configuration包绝不可反向 importmain；所有控制流必须由main主动发起。 -
flag 声明需在 Parse 前：所有
flag.XxxVar调用必须出现在flag.Parse()之前，且只能执行一次。 -
避免全局隐式状态：
Init()应设计为幂等或仅允许调用一次（可在函数内加sync.Once防重入，若需更严格约束）。 -
错误处理要提前终止：配置加载失败时应
os.Exit(1)，避免程序带无效配置继续运行。 -
考虑配置热加载？ 若后续需支持运行时重载，应将
flag.Parse()与配置加载解耦，但本场景以启动期一次性初始化为前提。
通过这种显式初始化模式，既保持了 configuration 包的独立性与复用性，又严格遵循 Go 的执行时序模型，彻底规避了因 init() 时机导致的 flag 未生效问题。
