Go 怎么读取命令行参数？3 种方式一次讲清，附可运行示例

你写了个 Go 小程序，想让它像普通命令那样接收用户输入的参数，最先想到的就是 os.Args。一句话结论：Go 读取命令行参数主要有三种方式——直接用 os.Args 切片拿到全部原始参数、用标准库 flag 包做带类型检查和帮助信息的 -flag 解析、用 flag.NewFlagSet 给每个子命令单独建一套解析规则。三者的复杂度递增、能力也递增：os.Args 最轻量零依赖，flag 包适合单一命令下的选项解析，FlagSet 适合 git 那样带子命令的工具。理解这三种方式的边界，能让你在解析 Go 命令行参数时少走弯路。下面先用一张表看清差异，再逐一给出可运行示例。

先看结论

记住一条铁律：简单取参用 os.Args，规范解析用 flag；子命令多了就用 FlagSet 拆分。

一、命令行参数在 Go 里长什么样

在 Go 里，命令行参数指启动程序时跟在可执行文件名后面的那一段字符串。标准库 os 包暴露的 os.Args 是一个 []string 切片，其中下标 0 是程序自身的路径或名字，下标 1 及之后才是用户真正传进来的参数。理解这个下标约定是后续一切解析的基础：你取参数几乎永远从 os.Args[1:] 开始，而不是从 0 开始，否则会把程序名也当成一个参数处理掉。

为什么需要比 os.Args 更结构化的方式？因为当参数变多、还要支持可选的 -name 这类开关时，纯手写切片解析既容易越界又难维护。Go 标准库为此提供了 flag 包，第三方生态还有更强大的解析器。但在上手 flag 之前，先看清原始参数长什么样很有必要，基础语法建议先过一遍 Go 教程。

还要注意，os.Args 拿到的全都是字符串，数字、布尔这类类型需要你自己转换，转换失败还要自己报错，这就是 flag 包存在的价值——它替你做类型检查和默认值。适用场景上，参数极简单、不想引入任何依赖时，os.Args 就够用；一旦选项变多就该升级。理解了原始形态，下面给出三种方式的具体写法。

二、os.Args 直接取全部参数

最轻量、零依赖的做法就是直接遍历 os.Args。它不依赖任何解析逻辑，适合参数结构极简、或者你只想原样拿到用户输入的场景。

package main

import (
    "fmt"
    "os"
)

func main() {
    args := os.Args
    fmt.Println("程序名:", args[0])
    fmt.Println("参数个数:", len(args)-1)
    for i, a := range args[1:] {
        fmt.Printf("参数%d: %s\n", i+1, a)
    }
}

运行程序并带两个参数：

go run main.go alice 18

预期输出如下，注意参数个数是 len 减一，因为下标 0 是程序名：

程序名: /tmp/go-build.../exe/main
参数个数: 2
参数1: alice
参数2: 18

如果你在 Linux 终端下跑，参数由 shell 负责切分后传给进程，空格就是分隔符；想传带空格的单个参数要用引号包起来。对比 Linux，Windows 下的命令行切分规则略有不同，可对照 Windows 教程 了解两者差异，避免同一段代码在不同平台取到不一样的切片。

失败排查：若下标越界 panic，说明用户没给够参数，正式程序里应该先检查 len(os.Args) 再访问。os.Args 的最大边界是它不做任何语义校验，数字参数要自己 strconv.Atoi，类型错误要自己提示。

三、flag 包做规范解析

当参数带上 -name 这类选项、且需要类型和默认值时，用标准库 flag 包最规范。这条命令式的入口内置了 String、Int、Bool 等类型，自动生成 -h 帮助信息，解析失败时给出清晰报错。

package main

import (
    "flag"
    "fmt"
)

func main() {
    name := flag.String("name", "world", "你的名字")
    age := flag.Int("age", 0, "你的年龄")
    flag.Parse()
    fmt.Printf("name=%s age=%d\n", *name, *age)
}

运行并传选项：

go run main.go -name bob -age 20

输出为 name=bob age=20；不传时则使用默认值 world 和 0。flag 包就是 Go 做命令行解析的标准入口，它把类型转换、默认值、帮助文案都包好了，比手写 os.Args 省心很多。

取舍上，flag 包适合单条命令下的若干选项；它的边界是所有选项共用同一套解析，不支持子命令。如果你熟悉 Rust，会知道 Rust 社区更常用 clap 这类库，对照 Rust 教程 能看到另一种设计哲学，但 Go 标准库的 flag 已经能满足绝大多数小工具。

注意 flag 默认在第一个非选项参数处停止解析，所以位置参数要放在选项之后；想完全自定义行为可以改用 FlagSet。

四、FlagSet 处理子命令

当你的程序像 git 那样拥有 start、stop 这类子命令，每个子命令还有自己的选项时，单一 flag.Parse 就不够用了，需要用 flag.NewFlagSet 给每个子命令单独建一套解析规则。

package main

import (
    "flag"
    "fmt"
    "os"
)

func main() {
    if len(os.Args) < 2 {
        fmt.Println("用法: app <start|stop>")
        os.Exit(1)
    }
    switch os.Args[1] {
    case "start":
        fs := flag.NewFlagSet("start", flag.ExitOnError)
        port := fs.Int("port", 8080, "监听端口")
        fs.Parse(os.Args[2:])
        fmt.Println("start on", *port)
    case "stop":
        fs := flag.NewFlagSet("stop", flag.ExitOnError)
        force := fs.Bool("force", false, "强制停止")
        fs.Parse(os.Args[2:])
        fmt.Println("stop, force=", *force)
    default:
        fmt.Println("未知子命令")
    }
}

运行 go run main.go start -port 9000 会输出 start on 9000，而 stop -force 则解析到 force 开关。每个 FlagSet 互不干扰，这正是子命令工具的骨架。运行后你可以验证子命令是否被正确分流、各自的选项是否独立生效。

边界在于：子命令名本身（start/stop）不在 FlagSet 里，需要你手动从 os.Args[1] 取并 switch；FlagSet 的 Parse 接收的是去掉子命令之后的剩余参数。和 C 语言比，C 只给你 argc/argv 原始数组、一切自己解析，对照 C 语言教程 能体会到 flag 包省下的工作量。失败排查时若选项不生效，先确认它属于哪个 FlagSet，再确认是否传到了对应子命令的解析里。

本文示例基于 Go 1.21 官方文档与本地实际运行（实际运行）。

总结

Go 读取命令行参数有三种递进的方式：os.Args 直接拿原始切片，零依赖但什么都不校验；flag 包提供带类型检查和帮助的选项解析，是单命令工具的标准选择；flag.NewFlagSet 给每个子命令独立建解析规则，适合 git 式多命令程序。记住简单取参用 os.Args、规范解析用 flag、子命令多了就拆 FlagSet。把解析边界划清楚，CLI 的可维护性能提升一大截。想继续练手可看 Go 官方教程。

延伸学习

• 课程：前端开发课程
• 相关笔记：Go 语言笔记
• 教程：Python3 教程

常见问题

Q：os.Args 和 flag 包有什么区别？什么时候该用哪个？

os.Args 是原始字符串切片，零依赖但不做任何类型转换和校验，适合参数极简的场景；flag 包内置类型、默认值和 -h 帮助，能自动报错，适合带选项的命令。规则是：选项少且都是字符串时用 os.Args，一旦需要 -name 这类带类型的开关就上 flag。

Q：go run 和 go build 之后运行，命令行参数读取有区别吗？

没有区别。os.Args 和 flag 解析的都是进程启动时的 argv，无论用 go run 临时编译运行，还是先 go build 再执行生成的二进制，参数传递方式完全一致，区别只在编译这一步。

Q：用 flag 解析时，参数顺序有什么限制？为什么有的选项不生效？

flag 默认在遇到第一个非选项参数（不是以 - 开头）时就停止解析，所以位置参数要放在所有选项之后。若你把位置参数夹在选项中间，后面的选项就不会被 flag 解析。需要更灵活的顺序时，改用 FlagSet 或把位置参数统一放到末尾。