最轻量闹钟核心用 time.afterfunc，传 time.duration 而非绝对时间；解析“14:30”需用 time.parseinlocation("15:04", input, loc) 补全当日日期；命令行用 flag.string 自解析 duration；响铃优先调用系统音频工具并 fallback 到 \a。
闹钟核心逻辑用 time.AfterFunc 最轻量
Go 里实现倒计时触发，time.AfterFunc 是最直接的选择：它不阻塞主线程，也不需要自己管理 goroutine 生命周期。别用 time.Sleep + fmt.Println 这种轮询写法——既不准又占资源。
常见错误是把时间计算写成 time.Now().Add(5 * time.Minute) 再传给 time.AfterFunc，这不对。time.AfterFunc 接收的是持续时间 time.Duration，不是绝对时间点。
- 正确写法：
time.AfterFunc(5*time.Minute, func() { fmt.Println("叮！") }) - 如果用户输入的是“14:30”，得先算出距离现在还有多久，再转成
time.Duration，不能直接传*time.Time - 注意：
time.AfterFunc的回调在新 goroutine 中执行，若需更新主程序状态（比如标记已响铃），要加锁或用 channel 同步
解析用户输入的时间字符串用 time.Parse 要配对布局
Go 的 time.Parse 不接受 “yyyy-mm-dd” 这类常见格式字符串，它强制使用魔数布局 "2006-01-02 15:04:05"。输错布局就会返回 parse time ...: month out of range 或静默失败。
典型场景是支持两种输入：“5m”（相对）和 “14:30”（绝对）。前者用正则提取数字+单位再换算；后者必须用 time.Parse("15:04", input)，且要手动补上今天日期，否则解析出的 Hour 是 0，导致闹钟永远设在过去。
立即学习“go语言免费学习笔记（深入）”；
- 解析 “14:30”：
t, err := time.Parse("15:04", "14:30")→ 得到当天 14:30:00，但t.Year()是 0，需用time.Now().AddDate(0,0,0).Truncate(24*time.Hour).Add(t.Sub(time.Time{}))补全日期 - 更稳的做法：用
time.ParseInLocation，显式指定本地时区，避免 UTC 偏移干扰 - 别依赖
time.Now().Format的输出去反推布局——它只是示例，不是语法
命令行参数解析用 flag 就够，别过早引入第三方
基础闹钟不需要 cobra 或 urfave/cli。Go 标准库 flag 完全能覆盖：支持 -d 30s、-at 9:00、-msg "开会了" 这类简单 flag，且自动处理 help 和类型转换。
容易踩的坑是没调用 flag.Parse() 就访问 flag.String 返回的指针值，结果 panic：assignment to entry in nil map。另外，flag.Duration 默认单位是纳秒，用户输 5m 会被当成 5 纳秒——必须文档写清，或改用 flag.String 自己 parse。
- 推荐组合：
duration := flag.String("d", "", "e.g. 5m, 1h30m")+ 手动解析字符串，比flag.Duration更可控 - 如果同时支持
-d和-at，要互斥校验，避免用户输两个导致逻辑混乱 -
flag.Usage可自定义，但别只写 “usage: alarm [flags]”，至少列个-d duration示例
响铃时播放声音得绕过系统限制，os/exec 调用 afplay 或 speaker-test
Go 本身不提供跨平台音频 API。macOS 用 afplay /System/Library/Sounds/Ping.aiff，Linux 用 speaker-test -l 1 -s 1 -t wav 或 aplay，Windows 最麻烦——得调 PowerShell 或放个 wav 文件。别试图用 syscall 直接操作音频设备，兼容性极差。
真实场景下，用户可能没装 speaker-test，或者路径里有空格导致 exec.Command 启动失败。错误信息通常是 exec: "speaker-test": executable file not found in $PATH，但程序不会报错退出，只会静音。
- 务必检查
cmd.Run()返回的 error，失败时 fallback 到终端\a响铃（部分终端支持） - macOS 上
afplay支持任意音频文件，可以内置一个短小的alarm.wav到二进制里（用go:embed），比调系统声更可靠 - 别用
cmd.Output()捕获输出——响铃不需要 stdout，反而拖慢响应
最麻烦的其实是时区和夏令时切换：如果用户设了“每天 9:00”，而系统在 DST 开始/结束当天重启程序，用 time.ParseInLocation 解析出的时间可能偏移一小时。这事没法完全规避，只能文档里提醒——复杂点从来不在代码行数，而在时间本身的不可靠。
