Go命令注册必须用指针类型（如&MyCmd{}），因值类型实例方法集不包含指针接收者方法，否则运行时panic；调度器需检测命名冲突并提供拒绝或强制覆盖策略；参数解析与Context传递须由调度器统一处理，命令接口应为Execute(ctx context.Context, args []string) error。
命令注册必须用指针类型，否则执行时方法接收者丢失
Go 语言中，Command 接口通常定义为 Execute() 方法。如果注册的是值类型实例（比如 MyCmd{}），而该方法是用指针接收者声明的（func (c *MyCmd) Execute()），那么运行时会 panic：value method MyCmd.Execute is not usable as type Command。
根本原因是 Go 类型系统对方法集的严格区分：值类型实例的方法集只包含值接收者方法；指针类型实例的方法集才同时包含值和指针接收者方法。
- 注册命令时统一用
&MyCmd{}，而不是MyCmd{} - 若想支持两种调用方式，所有命令方法必须统一用值接收者（但注意：内部状态修改将不生效）
- 推荐做法：命令结构体默认带字段（如
ID,Args），必须可变，因此强制使用指针接收者 + 指针注册
调度器需支持命名冲突检测与覆盖策略
命令名重复是常见问题——比如两个包都注册了 "deploy"。调度器不能静默覆盖，也不应直接 panic，而应提供显式策略：
-
Register(cmd Command, name string)默认拒绝重复注册，返回error - 提供
MustRegister(cmd Command, name string)强制覆盖（用于测试或插件热重载场景） - 内部用
map[string]Command存储，注册前先if _, exists := m[name]; exists { return errors.New("command already registered") }
注意：命令名建议标准化为小写、短横线分隔（如 "db:migrate"），避免空格和大写字母，方便 CLI 解析。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
参数解析要解耦，别把 flag.Parse 塞进 Command.Execute
把 flag.Parse() 或 pflag.Parse() 直接写在 Execute() 里，会导致命令无法被程序化调用（比如单元测试或 Web API 触发），也破坏单一职责。
正确做法是让调度器统一完成参数提取，再透传给命令：
type Command interface {
Execute(args []string) error
}
// 调度器内部：
cmd, ok := registry[name]
if ok {
return cmd.Execute(os.Args[2:]) // 跳过命令名本身
}
- 命令自身不依赖
os.Args，只处理明确传入的args - 全局 flag（如
--verbose）由调度器提前解析，通过字段或上下文注入命令实例 - 若需结构化参数，建议命令实现
SetFlags(*flag.FlagSet)方法，由调度器调用并绑定
Context 传递不可省略，超时与取消必须由调度器统一控制
很多命令需要网络请求、数据库操作或长时间计算，硬编码 time.Sleep 或无限制等待会卡死整个调度流程。必须让 Execute 接收 context.Context。
修改接口为：
type Command interface {
Execute(ctx context.Context, args []string) error
}
- 调度器启动命令前创建带超时的子 Context：
ctx, cancel := context.WithTimeout(parentCtx, 30*time.Second) - 命令内部所有阻塞操作（
http.Client.Do、db.QueryContext）都必须传入该ctx - 调度器在 defer 中调用
cancel()，确保资源及时释放
忽略 Context 的命令看似简单，但上线后极易引发 goroutine 泄漏和级联超时失败。
