flag更适合高兼容性小工具，因其是go标准库、零依赖、二进制轻量（比cobra小2–3mb），可在linux 2.6+、macos 10.7+、windows xp+直接运行，避免cobra在旧系统、低资源设备或ci环境中的启动延迟与依赖风险。
为什么 flag 比 cobra 更适合高兼容性场景
小工具要跑在旧系统、低资源设备或 CI 环境里，cobra 带来的二进制体积膨胀（+2–3MB）、启动延迟和依赖链风险会直接拉低兼容性。而 flag 是标准库，零额外依赖，编译出的二进制在 Linux 2.6+、macOS 10.7+、Windows XP+ 都能直接运行。
- 别用
cobra-cli init脚手架——它默认生成cmd/目录结构和viper、logrus等非必需依赖，增加出错面 - 避免在
init()里做任何 I/O 或网络调用，比如自动检查更新、读取远程配置，这些在离线环境必然失败 - 所有字符串操作用
strings.TrimSpace而不是strings.Trim，前者对 Windows CRLF 和 macOS CR 更鲁棒
如何让命令行参数解析不因 shell 差异崩溃
不同 shell（bash/zsh/fish/PowerShell）对引号、空格、通配符的处理逻辑不同，硬编码参数解析逻辑很容易漏掉边界情况。
- 永远用
flag.Parse()解析 flag，之后用flag.Args()拿剩余位置参数，别碰os.Args[1:]—— PowerShell 会把带空格路径拆成多个元素，flag.Args()已内部处理 - 路径参数统一用
flag.String声明，不要设默认值（如./input.txt），否则用户不传参时程序会试图打开当前目录下不存在的文件 - 布尔 flag 别依赖隐式赋值，显式写
-verbose=true或-verbose=false，避免 zsh 把-v当作短选项合并解析
跨平台文件与编码兼容的关键动作
本地工具常要读写用户文件，但 Windows 默认用 CP1252、macOS 用 UTF-8、Linux 大多 UTF-8 —— 不做适配，中文路径或内容一读就乱码或 panic。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 打开文件前先用
filepath.FromSlash统一路径分隔符，把dir/file.txt转成dir\file.txt（Windows）或保持原样（其他系统） - 读文本文件时，用
bufio.NewReader包一层，再调ReadString('\n')，比直接ioutil.ReadFile更容错：能跳过 BOM、自动适配 CRLF/LF - 写文件时，用
os.O_CREATE | os.O_WRONLY | os.O_TRUNC打开，别用os.O_APPEND—— 在某些 FAT32 U 盘上，O_APPEND会导致写入位置错乱
错误提示必须带上下文，否则用户根本没法修
“invalid JSON” 这种错误在用户机器上毫无价值。真正的兼容性体现在错误信息能否指向真实问题位置。
- JSON 解析失败时，用
json.SyntaxError.Offset计算行号：bytes.Count(data[:offset], []byte{'\n'}) + 1，然后输出ERROR: invalid JSON at line 42, column 5 in input.json - 所有错误都用
fmt.Errorf("xxx: %w", err)包裹，保留原始 error 类型，方便调用方做类型断言（比如判断是不是os.IsNotExist） - stderr 输出必须用
log.New(os.Stderr, "ERROR: ", 0)，别用fmt.Fprintln(os.Stderr, ...)—— 前者带时间戳前缀且线程安全，后者在并发调用时可能输出错乱
真正难的不是让程序在自己机器上跑通，而是让它在别人删了家目录、换了 shell、插着只读 U 盘、开着杀毒软件的电脑上也不崩 —— 这些细节堆起来，才是高兼容性的底子。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
