Golang实现一个最简单的命令行程序示例_技术教程

Go程序入口func main()必须位于package main中，签名固定为无参数无返回值，且一个目录下只能有一个；使用flag包解析命令行参数需调用flag.Parse()，支持--name=Tom等格式，不支持位置参数。

main 函数必须在 package main 里

Go 程序入口是 func main()，它只能出现在 package main 中。如果写成其他包名（比如 package cmd），go run 会报错：cannot run non-main package。这不是语法错误，而是构建约束——Go 编译器直接拒绝执行。

实操建议：

新建文件时第一行必须是 package main
main 函数不能带参数、不能有返回值（签名固定为 func main()）
一个目录下只能有一个 package main，否则 go run . 会报 multiple main packages

用 flag 包读取最简命令行参数

Go 标准库的 flag 包足够应付“最简单”的需求，比如接收一个字符串或整数参数，不需要第三方依赖。

常见错误现象：直接用 os.Args 手动解析，结果漏掉 Args[0] 是程序名，或没处理空参数、类型转换失败等边界情况。

立即学习“go语言免费学习笔记（深入）”；

实操建议：

用 flag.String / flag.Int 声明参数，自动处理默认值、类型转换和帮助信息
必须调用 flag.Parse() 才能触发解析，否则所有 flag.Xxx 返回零值
帮助信息（-h / --help）是内置的，不用额外写逻辑

package main

import (
    "flag"
    "fmt"
)

func main() {
    name := flag.String("name", "World", "your name")
    flag.Parse()
    fmt.Printf("Hello, %s!\n", *name)
}

编译后运行时传参格式要严格

Go 编译出的二进制不支持 ./cmd --name=Tom 和 ./cmd --name Tom 混用——flag 包对等号格式敏感，且只认 --xxx 或 -x 形式，不接受 ./cmd Tom 这种无 flag 名的位置参数（除非显式用 flag.Args()）。

使用场景：调试阶段常用 go run . --name=Alice；发布时用 go build -o hello && ./hello --name=Bob。

容易踩的坑：

忘记空格：--name=Tom ✅，--name= Tom ❌（等号后有空格会导致值为空）
短选项拼接错误：-name Alice ❌（name 不是单字母，不能用短格式），应写 --name Alice
参数顺序：flag 必须在非 flag 参数之前，./hello --name Tom extra 中 extra 会进入 flag.Args()，但 --name 仍能正确解析