Files
knowledge-governance/internal/version/version.go
T
姚章浩 c04abd6530 style(go): 清掉存量 gofmt(6 个文件的字段对齐与文件末尾换行)
接入格式门禁前先量了一次存量:gofmt -l 在 295 个被跟踪的 .go 文件里报 6 个,
全是字段对齐与缺文件末尾换行这类机械问题。先一次性清干净,门禁接上后 Go 侧一条都不欠。

为什么独立一个提交:格式清理混进功能改动会让 diff 无法 review(正本要求存量清理独立提交)。
验证:gofmt -l 对被跟踪的 .go 文件输出为空;go vet 与 go test 全过。
2026-10-12 00:10:31 +08:00

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"
)