c04abd6530
接入格式门禁前先量了一次存量:gofmt -l 在 295 个被跟踪的 .go 文件里报 6 个, 全是字段对齐与缺文件末尾换行这类机械问题。先一次性清干净,门禁接上后 Go 侧一条都不欠。 为什么独立一个提交:格式清理混进功能改动会让 diff 无法 review(正本要求存量清理独立提交)。 验证:gofmt -l 对被跟踪的 .go 文件输出为空;go vet 与 go test 全过。
29 lines
1.4 KiB
Go
29 lines
1.4 KiB
Go
// Package version 承载"这个二进制是什么"的构建期身份。
|
|
//
|
|
// 三个值**全部由构建期注入**(正本 §6.1:版本号只有一个来源,且要能从产物读回来):
|
|
//
|
|
// go build -trimpath \
|
|
// -ldflags "-X knowledge-governance/internal/version.Number=$(python3 scripts/version.py) \
|
|
// -X knowledge-governance/internal/version.CommitSHA=$(git rev-parse --short=12 HEAD) \
|
|
// -X knowledge-governance/internal/version.BuildTime=$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
|
|
// ./cmd/api
|
|
//
|
|
// 三条纪律:
|
|
//
|
|
// 1. **不要**把它们改成编译期常量,也**不要**另建仓库根的 VERSION 文件 ——
|
|
// 版本号的唯一来源是 CHANGELOG.md,由 scripts/version.py 解析。
|
|
// 放第二份副本的结果是发版要改两处,忘一处就漂移。
|
|
// 2. **不要**给这些变量设"看起来正常的默认值"。未注入时保持下面的零值,
|
|
// 好让"忘了注入"表现成一个显眼的 dev,而不是一个假的正经版本号。
|
|
// 3. `Number` 的正确性由 internal/version 的契约测试兜底:注入进去的号
|
|
// 必须等于 CHANGELOG.md 顶部的已发布版本(CI 会带 -ldflags 跑它,
|
|
// 并额外断言"没有 SKIP" —— 被跳过的断言等于没有断言)。
|
|
package version
|
|
|
|
// Number / CommitSHA / BuildTime 由 -ldflags -X 注入;未注入时保持下面的值。
|
|
var (
|
|
Number = "dev"
|
|
CommitSHA = "unknown"
|
|
BuildTime = "unknown"
|
|
)
|