Go 标准库 flag 包不支持隐藏特定标志（使其不显示在 --help 输出中），也不支持强制将短选项（如 -v）显示为长格式（如 --verbose）；需借助第三方库（如 github.com/jessevdk/go-flags）实现灵活的命令行解析与帮助定制。
go 标准库 `flag` 包不支持隐藏特定标志（使其不显示在 `--help` 输出中），也不支持强制将短选项（如 `-v`）显示为长格式（如 `--verbose`）；需借助第三方库（如 `github.com/jessevdk/go-flags`）实现灵活的命令行解析与帮助定制。
Go 的标准 flag 包设计简洁、轻量，但功能相对基础：所有通过 flag.String()、flag.Bool() 等注册的标志默认都会出现在 --help 输出中，且短选项（如 -h）与长选项（如 --help）在帮助文本中统一按注册形式展示，无法隐藏某标志，也无法重写其帮助行显示格式（例如强制显示为 --secret 而非 -s）。
若需实现“隐藏标志”（即运行时仍可解析 --secret-key xxx，但 --help 中完全不列出该选项），或要求帮助文本中统一使用长格式命名（如显示 --output 而非 -o, --output），推荐使用功能更丰富的第三方库 —— github.com/jessevdk/go-flags。
该库支持：
- ✅ 通过 hidden: true 标签隐藏字段，使其不参与帮助生成；
- ✅ 使用 long:"output" 显式声明长名称，并通过 short:"o" 可选定义短名，帮助中默认只显示长格式（或按需组合）；
- ✅ 支持分组、环境变量绑定、嵌套结构等高级特性。
示例代码（使用 go-flags 实现隐藏 --api-token 并规范帮助输出）：
package main
import (
"fmt"
"os"
"github.com/jessevdk/go-flags"
)
type Options struct {
Verbose bool `long:"verbose" short:"v" description:"Enable verbose logging"`
Output string `long:"output" short:"o" description:"Output file path"`
APIToken string `long:"api-token" hidden:"true" description:"API authentication token (not shown in help)"`
}
func main() {
var opts Options
parser := flags.NewParser(&opts, flags.Default)
_, err := parser.Parse()
if err != nil {
if flagsErr, ok := err.(*flags.Error); ok && flagsErr.Type == flags.ErrHelp {
os.Exit(0)
}
fmt.Fprintf(os.Stderr, "%s\n", err)
os.Exit(1)
}
fmt.Printf("Verbose: %v, Output: %s, Token length: %d\n",
opts.Verbose, opts.Output, len(opts.APIToken))
}运行 ./app --help 将仅显示 --verbose, --output 及其别名，而 --api-token 完全不可见；但用户仍可通过 ./app --api-token=xxx 正常传入值。
⚠️ 注意事项：
- go-flags 不兼容标准 flag 的全局状态（如 flag.Parse()），需显式创建 Parser 实例；
- 隐藏标志不提供任何文档提示，应确保内部使用场景明确，避免协作混乱；
- 若项目强依赖标准库最小化原则，可考虑封装 flag.FlagSet 并手动控制 Usage 函数，但无法优雅支持“隐藏+格式重写”双重需求。
综上，标准 flag 包无法满足隐藏选项和自定义帮助显示格式的需求；go-flags 是成熟、稳定、广泛采用的替代方案，兼顾表达力与可维护性，推荐在中大型 CLI 工具中优先选用。
