Go Cobra PersistentPreRunE 为什么没有同时执行父子钩子

如果你在 Cobra 的父命令和子命令上都声明了 PersistentPreRunE，却发现执行子命令时只有一个钩子生效，通常不是函数签名写错，而是 Cobra 的默认继承策略在起作用：命令链上默认只执行找到的第一个持久化钩子。需要父子钩子都参与时，显式设置 cobra.EnableTraverseRunHooks = true，再把共享初始化和命令专属校验分开。

官方地址：https://github.com/spf13/cobra/blob/main/site/content/user_guide.md

最小判断：父级的 PersistentPreRunE 负责可复用的公共准备；子级如果也要执行自己的持久化钩子，开启 EnableTraverseRunHooks。如果只需要当前命令的校验，优先使用子命令的 PreRunE，不要为了“继承”而打开全局遍历。

先分清 PersistentPreRunE 和 PreRunE

Cobra 把命令生命周期拆成持久化钩子、普通钩子和主处理函数。PersistentPreRunE 可以被子命令继承，PreRunE 只属于当前命令；错误版本则分别对应返回 error 的写法。官方文档给出的典型顺序是持久化前置钩子、普通前置钩子、主处理、普通后置钩子和持久化后置钩子。

这里的“继承”不是“父子函数全部自动叠加”。它表示子命令在没有自己的同类持久化钩子时，可以使用祖先命令找到的那一个实现。父命令适合放配置加载、日志上下文或公共依赖准备；当前命令的参数约束和业务前置检查，通常放在 PreRunE。

为什么默认只执行一个持久化钩子

Cobra 默认采用“命令链上第一个持久化钩子”的策略。假设 root、parent、child 都可能定义 PersistentPreRunE，执行 child 时，框架会先找到适用的持久化钩子；默认模式不会把父级和子级同名钩子逐个累加调用。这样做可以避免一个初始化函数因为命令树层层继承而重复执行。

因此，下面这段代码里，子命令拥有自己的 PersistentPreRunE 时，不要期待 root 的同名钩子和 child 的同名钩子天然组成一个调用链。示例只用于展示配置位置，未把输出当作运行证据。

package main

import "github.com/spf13/cobra"

var rootCmd = &cobra.Command{
    Use: "app",
    // 父级钩子放公共准备，例如读取全局配置。
    PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
        return loadSharedConfig(cmd)
    },
}

var childCmd = &cobra.Command{
    Use: "sync",
    // 子级同名钩子会参与默认选择，而不是自动与父级叠加。
    PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
        return prepareSync(cmd)
    },
    // 当前命令自己的参数检查更适合放在 PreRunE。
    PreRunE: func(cmd *cobra.Command, args []string) error {
        return checkSyncArgs(args)
    },
    RunE: func(cmd *cobra.Command, args []string) error {
        return runSync(cmd, args)
    },
}

func main() {
    // 命令注册关系决定了父子继承范围。
    rootCmd.AddCommand(childCmd)
    _ = rootCmd.Execute()
}

这个规则也解释了常见误区：把 root 和 child 都写成 PersistentPreRunE，然后只看到其中一个生效，并不代表 Cobra 丢失了函数；它是在默认策略下避免同类持久化钩子重复叠加。

需要父子都执行时打开遍历

如果你的设计确实需要沿命令树执行多个持久化钩子，可以设置全局变量 cobra.EnableTraverseRunHooks = true。它改变的是持久化钩子的遍历策略，不会把普通的 PreRunE 变成父子级联。启用后，建议让每一级只承担清晰的一类职责。

func buildRoot() *cobra.Command {
    // 显式打开父子持久化钩子的遍历策略。
    cobra.EnableTraverseRunHooks = true

    root := &cobra.Command{
        Use: "app",
        PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
            // 只做所有子命令都需要的共享初始化。
            return loadSharedConfig(cmd)
        },
    }

    syncCmd := &cobra.Command{
        Use: "sync",
        PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
            // 只做 sync 专属的依赖准备，避免重复加载全局配置。
            return prepareSync(cmd)
        },
        PreRunE: func(cmd *cobra.Command, args []string) error {
            // 参数校验失败直接返回，阻止后续 RunE。
            return checkSyncArgs(args)
        },
        RunE: func(cmd *cobra.Command, args []string) error {
            // 主逻辑只接收已完成前置准备的命令上下文。
            return runSync(cmd, args)
        },
    }
    root.AddCommand(syncCmd)
    return root
}

开启遍历后，最重要的不是“让两个函数都跑起来”，而是重新定义每层的契约。父级钩子负责共享初始化，子级钩子负责本命令的依赖准备，PreRunE 负责本命令参数检查，RunE 只承担业务执行。

错误处理和兼容策略怎么安排

持久化钩子使用 PersistentPreRunE 而不是无返回值的 PersistentPreRun，是因为配置读取、依赖连接和权限准备都可能失败。任何一层返回非空错误，调用方都应让执行链停止，并由最外层统一处理。不要在钩子里吞掉错误再让 RunE 猜测上下文是否完整。

开启全局遍历属于行为开关，老项目改造时要特别注意重复初始化：例如父级已把配置写入命令上下文，子级不应再次读取并覆盖；父级已经创建连接池，子级应复用而不是重新创建。若只有一个子命令需要额外检查，保留默认策略并在该子命令使用 PreRunE，改动范围更小。

常见问题

只设置子命令的 PreRunE，父级 PersistentPreRunE 还会继承吗？

会。两者不是同一类字段：父级的持久化前置钩子仍可被子命令继承，子命令的 PreRunE 则只负责当前命令自己的前置检查。

打开 EnableTraverseRunHooks 后所有 PreRunE 也会遍历吗？

不会。这个开关针对持久化钩子的父子遍历；普通 PreRunE 仍然属于当前命令。设计时应分别检查钩子类型和命令层级。

怎样避免父子 PersistentPreRunE 重复加载配置？

把配置读取放在父级，把子级钩子限定为本命令独有的准备；需要共享的数据通过命令上下文或显式依赖传递，不要让每个钩子都重新初始化同一资源。