Go 规范要求构建系统按词法文件名顺序向编译器提供同一包内的多个源文件，以保证 init() 函数调用顺序确定且可重现。
go 规范要求构建系统按词法文件名顺序向编译器提供同一包内的多个源文件，以保证 `init()` 函数调用顺序确定且可重现。
在 Go 程序初始化过程中，当一个包包含多个 .go 文件时，每个文件中定义的 init() 函数将按特定顺序依次执行。该顺序并非随机，也不由文件声明位置或编译时间决定，而是由 Go 规范明确定义的——即 lexical file name order（词法文件名顺序）。
所谓“词法顺序”，本质是字符串的字典序（lexicographic order）：将文件名视为纯字符串，逐字符依据其 Unicode 码点（等价于 ASCII 码点，对英文字符而言）进行比较。例如：
a.go < b.go main.go < util.go config_v1.go < config_v10.go // 注意：'1' < '10' 是字符串比较，非数值比较！ z_test.go < z.go // '_' 的码点（95）小于字母 'a'（97）
✅ 正确示例（按词法升序排列的文件）：
db.go http.go main.go utils.go
编译器将严格按此顺序解析并执行其中的 init() 函数。
⚠️ 注意事项：
- 词法排序不区分大小写？不！ Go 严格区分大小写：A.go（码点 65）排在 a.go（码点 97）之前；
- 数字按字符处理：v2.go 在 v10.go 之前（因为 '2' > '1'），这与人类直觉不同，需特别警惕；
- 特殊字符参与排序：-（45）、_（95）、.（46）均按其 ASCII 值参与比较，例如 api_v1.go 't' 不成立，实际比较到第9位：'v'=='v', '1'=='1', '.'
- 该顺序仅影响同一包内多个文件的 init() 执行次序，不影响跨包初始化（后者由依赖图决定）；
- 若依赖特定 init() 执行顺序，请显式通过函数调用或 sync.Once 控制逻辑，切勿隐式依赖文件名顺序——这是脆弱的设计；词法排序只是保障行为可重现的底层机制，而非推荐的编程契约。
总结：词法文件名排序是 Go 构建系统的一项关键约定，它消除了多文件包初始化顺序的不确定性，使 go build 和 go run 在相同输入下始终产生一致的行为。理解并尊重这一机制，有助于编写可预测、易调试、符合 Go 工程实践的代码。
