Caddy 手动编译会默认改版本号为devel，如何手动指定版本号

根据您提供的代码片段和注释，CustomVersion 是一个关键变量，用于在无法从 Go 的构建信息（如 go.mod 或 VCS 信息）中提取版本号时手动指定版本号。以下是关于如何手动指定版本号的详细分析和实现方法。

---

1. 手动指定版本号的关键点

a. 使用 CustomVersion 变量

• 注释中提到：

  CustomVersion is always prepended to the full version string.

  • 如果 CustomVersion 被设置，则它会被添加到完整版本字符串的开头。
• 在代码逻辑中，CustomVersion 的优先级高于默认的 "unknown" 或从构建信息中提取的版本号。

b. 设置 CustomVersion 的位置

• 您需要在代码中显式地定义和设置 CustomVersion 变量。
• 示例：

  var CustomVersion = "v1.2.3-custom"

---

2. 实现手动指定版本号的方法

以下是具体的实现步骤：

a. 定义 CustomVersion

在代码中定义 CustomVersion 变量，并赋值为您希望的手动版本号。例如：

var CustomVersion = "v1.2.3-custom"

b. 确保 CustomVersion 的优先级

根据代码逻辑，CustomVersion 的值会在以下情况下被使用：

1. 当无法从 debug.ReadBuildInfo() 中提取版本信息时。
2. 当从 debug.ReadBuildInfo() 提取的版本信息为空时。
3. 即使从构建信息中提取了版本号，CustomVersion 也会被前置到完整版本字符串中。

c. 修改构建流程

如果您希望通过构建脚本动态设置 CustomVersion，可以使用 Go 的 -ldflags 参数在编译时注入版本号。例如：

go build -ldflags "-X main.CustomVersion=v1.2.3-custom"

• 这里的 -X 参数会将 main.CustomVersion 的值设置为 v1.2.3-custom。
• 注意：CustomVersion 必须是包级变量（var），并且必须导出（首字母大写）或在 main 包中定义。

---

3. 示例代码

以下是一个完整的示例，展示如何手动指定版本号并验证其行为：

a. 定义 CustomVersion

 

package main

import (

"fmt"

"runtime/debug"

"strings"

)

var CustomVersion string // 手动指定的版本号

// Version 函数

func Version() (simple, full string) {

bi, ok := debug.ReadBuildInfo()

if !ok {

if CustomVersion != "" {

full = CustomVersion

simple = CustomVersion

return

}

full = "unknown"

simple = "unknown"

return

}

// 尝试从模块信息中提取版本号

for _, dep := range bi.Deps {

if dep.Path == "github.com/your/module/path" { // 替换为实际模块路径

simple, full = dep.Version, dep.Version

break

}

}

// 如果仍然没有版本号，使用 CustomVersion

if full == "" {

if CustomVersion != "" {

full = CustomVersion

simple = CustomVersion

} else {

full = "unknown"

simple = "unknown"

}

} else if CustomVersion != "" {

full = CustomVersion + " " + full

}

return

}

func main() {

// 手动指定版本号

CustomVersion = "v1.2.3-custom"

// 获取版本号

simple, full := Version()

fmt.Println("Simple Version:", simple)

fmt.Println("Full Version:", full)

}

b. 构建时注入版本号

通过 -ldflags 参数动态注入版本号：

  

go build -ldflags "-X main.CustomVersion=v1.2.3-custom"

运行生成的二进制文件后，输出如下：

复制

 

Simple Version: v1.2.3-custom

Full Version: v1.2.3-custom unknown

---

4. 验证手动指定版本号的效果

a. 未设置 CustomVersion 的情况

如果未设置 CustomVersion，且无法从构建信息中提取版本号，则返回默认值：

go

 

Simple Version: unknown

Full Version: unknown

b. 设置 CustomVersion 的情况

如果设置了 CustomVersion，则返回手动指定的版本号：

 Simple Version: v1.2.3-custom

Full Version: v1.2.3-custom unknown

c. 结合构建信息的情况

如果从构建信息中提取了版本号，但同时设置了 CustomVersion，则 CustomVersion 会被前置到完整版本字符串中：

 Simple Version: v1.2.3-custom

Full Version: v1.2.3-custom v0.15.0 (commit hash)

---

5. 总结

要手动指定版本号，可以通过以下方式实现：

1. 定义 CustomVersion 变量 ：
   • 在代码中显式设置 CustomVersion 的值。
2. 通过构建参数注入版本号 ：
   • 使用 -ldflags 参数动态设置 CustomVersion。
3. 确保优先级 ：
   • CustomVersion 的值会在无法提取构建信息时作为默认值，或者前置到完整版本字符串中。

这种方式非常灵活，适合在 CI/CD 流程中动态生成版本号，同时也允许开发者手动指定版本号以满足特定需求。如果您有更多具体问题或需要进一步调整，请随时提问！